Page Comparison

ClientCustomerId

optional

the id of the customer in the external/interfacing system. This id is assumed to be unique within the brand and is used to lookup the record in the internal database in order to determine whether an insert or update is made. If you plan on using OmedaCustomerId as the way to identify the user, do not pass in this element.

OmedaCustomerId

optional

the internal id of the customer. This id is unique. Providing this guarantees that identityresolution processing will be bypassed. You should provide this id only if you are certain that the data provided in this call is definitely associated with the individual specified by the id. If you plan on using ClientCustomerId as the way to identify the user, do not pass in this element.

ExternalCustomerId

optional

the external customer id that can be used to identity a customer.

ExternalCustomerIdNamespace

optional

the namespace that is associated with which the ExternalCustomerId will be associated with. Please contact your Omeda Account Manager to determine what needs to be sent in here. It is recommended if the ExternalCustomerId is on the request, that this field is also set, otherwise the default will be used, if there is no default an error will be returned.

CustomerStatusId

optional

the status of the submitted customer. 0 = Inactive, 1 = Active, 3 = Test

Salutation

optional

salutation (Ms., Mr. , Dr. etc) of customer, up 10 characters long

FirstName

optional

first name of customer, up to 100 characters long

MiddleName

optional

middle name of customer, up to 100 characters long

LastName

optional

last name of customer, up to 100 characters long

Suffix

optional

suffix of customer (Jr. Sr., III, etc.) , up to 10 characters long

Title

optional

job title, up to 100 characters long

Gender

optional

(M,F) male=M, female=F

SignupDate

optional

Two formats are available: yyyy-MM-dd and yyyy-MM-dd HH:mm. Date the person signed up

ClientOrderId

optional

Client assigned order ID.This is an integer value.

PromoCode

optional

Promocode for all product orders in this call,up to 50 char long.

OrderDate

optional

Date of order, If missed, default is today’s date

Addresses

optional

JSON element containing multiple Address elements (see below)

Phones

optional

JSON element containing multiple Phone elements (see below)

Emails

optional

JSON element containing multiple Email elements (see below)

CustomerDemographics

optional

JSON element containing multiple CustomerDemographic elements (see below)

Products

optional

JSON element containing multiple Product Elements elements (see below)

Telemarketing

optional

JSON element containing multiple Telemarketing Elements elements (see below)

DonorId

optional

This field is used for Gift Subscriptions. DonorId is the OmedaCustomerId of a different existing customer who is giving gift subscription(s). If provided, all subscriptions for this transaction will be considered Gift Subscriptions given by the DonorId customer.

MergeCode

optional

This field is used to specify whether the customer record should be mergeable or non-mergeable. When a mergeable record is processed, if another customer record sufficiently matches the merge criteria, the data from both records will be merged into one record. Valid values are “1”, indicating the record is mergeable, and “0”, indicating the record is non-mergeable. If no value is provided, the default value is “1”.

AddressContactType

optional

see Address Contact Types. If none is provided, 100 (business) is assumed.

Company

optional

if the address contains a company name put it here, up to 255 characters long. Do not use the Street, ApartmentMailStop, or ExtraAddress fields to store company name information.

Street

optional

first line of street address, up to 255 characters long

ApartmentMailStop

optional

apartment, mail stop or suite number, up to 255 characters long

ExtraAddress

optional

last line of street address, only if necessary, up to 255 characters long

City

optional

city name, up to 100 characters long

RegionCode

optional

For country_code=’USA’ or ‘CAN’, this must be the 2-character US state or canadian code used by the postal service. Omeda also has region codes for other countries of the world

Region

optional

name of region. Only used when region_code cannot be given. Should contain the region, up to 100 characters long.

PostalCode

optional

ZIP code or postal code.

CountryCode

optional

3-character country code

Country

optional

Name of country. Only used when country code cannot be provided. Should contain the country, up to 100 characters long.

AddressProducts

optional

Comma-separated list of product ids to associate this address with or one of the following keywords; “ALL” (All products), “NONE” (No Products), “ALL_PRINT” (All Products that are of “Magazine” type), “ALL_NEWSLETTER” (All Products that are of “Newsletter” type. If ommitted, default is “NONE”.

Airmail

optional

If including this entry in the JSON the only valid submissions are “A” or an empty string “”. An empty string is the only way to clear an existing entry of “A”.

EmailContactType

optional

see Email Contact Types. If none is provided, 300 (primary/business) is assumed.

EmailAddress

required

email address, must be properly formatted

EmailProducts

optional

Comma-separated list of product ids to associate this email address with or one of the following keywords; “ALL” (All products), “NONE” (No Products), “ALL_PRINT” (All Products that are of “Magazine” type), “ALL_NEWSLETTER” (All Products that are of “Newsletter” type. If ommitted, default is “NONE”.

PhoneContactType

optional

see Phone Contact Types. If none is provided, 200 (business) is assumed.

Number

required

phone number

Extension

optional

separate extension digits, if known

OmedaDemographicId

conditional

Identifier that specifies the explicit omeda demographic ID. This is an integer value. Either the ClientDemographicId or OmedaDemographicId is required.

OmedaDemographicValue

conditional

Holds the explicit value id that is associated with the OmedaDemographicId provided above. This is a String value. If OmedaDemographicId is present then OmedaDemographicValue must be present but either the ClientDemographicValue or OmedaDemographicValue is required.

WriteInDesc

optional

“Other” text description, 100 char max. Only single response and multi response demographics can have values for the WriteInDesc field and only applicable to demographic values with value type of “Other”.

OmedaProductId

conditional

integer

Explicit Omeda product id for the product being requested. Note: If any product information is provided then OmedaProductId must be given.Only Magazines (productType=1) and Newsletters (productType=2) can be updated via this API. Use the OptIn/Optout APIs forEmail Deployment updates (productType=5) and the Assign Behavior API for Event updates (prouductType=3). For a full list of types see Product Types.

Receive

optional

short

1 = opt-in, 0 = opt-out. Assumed to be 1 if not given. Explicitly allows this order service to capture opt-out behaviors as part of the order transaction.

Quantity

optional

integer

Quantity requested. Assumed to be 1 if not given.

PersonalIdentifier

optional

string

A Personal Identifier for the product. For example, “What is your Eye Color?” Maximum of 50 characters.

RequestedVersion

optional

char

Applicable only for products that have different versions (‘P’ for print, ‘D’ for digital, ‘B’ for both).

ShippingAddressId

optional

integer

Explicit Omeda postal address id for the customer. Note: if submitted, OmedaCustomerId must be given.

EmailAddressId

optional

integer

Explicit Omeda email address id for the customer. Note: if submitted, OmedaCustomerId must be given.

Term

conditional

integer

Term (duration) of the subscription. You must specify Term or OrderExpirationDate per paid product.

PricePerQuantity

optional

decimal

Price per quantity.

DiscountPercentage

optional

decimal

Percentage Discount for order.

PaymentStatusId

optional

integer

Payment status of the subscription. Omit this element if there is no payment being made. Payment Status Codes

Amount

optional

decimal

Total amount that will be billed or charged for this transaction (not including shipping or tax).

AmountPaid

optional

decimal

Amount that will be paid immediately as part of this transaction.

SalesTax

optional

decimal

Sales Tax that will be paid as part of this transaction.

Postage

optional

decimal

Postage that will be paid as part of this transaction.

PurchaseOrderNumber

optional

string

A number generated by the client in order to authorize a purchase transaction

StartIssueDate

optional

date

The starting date of the first issue (yyyy-MM-dd)

OrderExpirationDate

conditional

date

Expiration date of the order (yyyy-MM-dd). You must specify Term or OrderExpirationDate per paid product.

AutoRenewalCode

optional

integer

Code used to indicate automatic subscription renewal type: 0 = No Renewal, 5 = On Expire – Auto-Charge, 6 = On Expire – Send Invoice.For new subscriptions, AutoRenewalCode should be excluded if no auto renewal is needed.

NumberOfInstallments

optional

integer

Total number of installments to receive.

Sku

conditional

string

Product code or tracking number. Required for Single Copy Sales products.

OmedaProductIdUpdate

conditional

integer

Explicit Omeda product id for the product being requested. Note: If any product information is provided then OmedaProductIdUpdate must be given.Only Magazines (productType=1) and Newsletters (productType=2) can be updated via this API. Use the OptIn/Optout APIs forEmail Deployment updates (productType=5) and the Assign Behavior API for Event updates (prouductType=3). For a full list of types see Product Types.

RequestedVersionUpdate

optional

char

Applicable only for products that have different versions (‘P’ for print, ‘D’ for digital, ‘B’ for both).

CreditCardNumber

optional

string

Only to be used for 3rd party payment.
New Credit Card Number that will replace the Credit Card Number on file that is related to all Paid Subscriptions for the Customer Id and Product Id. Omeda suggests using Test Credit Cards when testing in our Staging environment

CreditCardType

conditional

integer

Only to be used for 3rd party payment.
Required field if CreditCardNumber is submitted. The code associated with the Credit Card Type Valid Values: see Credit Card Type Codes.

ExpirationDate

conditional

string

Only to be used for 3rd party payment.
Required field if CreditCardNumber is submitted. The Expiration Date for the Credit Card Number passed in on the request (MMYY)

CardSecurityCode

conditional

string

Only to be used for 3rd party payment.
Required field if CreditCardNumber is submitted. The Card Security Code for the Credit Card Number passed in on the request

NameOnCard

conditional

string

Required field if CreditCardNumber is submitted. The Full Name associated with the Credit Card Number passed in on the request.

DoCharge

required

string

This value should always be “False”.

DepositDate

conditional

date

Date that payment was made (yyyy-MM-dd). DepositDate is required for 3rd party payment.

AuthCode

conditional

string

Authorization code. AuthCode is required for 3rd party payment.

Comment1

optional

string

Optional comment which may display on merchant account reports (depending on merchant account). Omeda recommends passing the Magazine name or Brand name into this field.

Comment2

optional

string

Optional comment which may display on merchant account reports (depending on merchant account). Omeda recommends passing the OmedaCustomerId into this field for existing customers, or passing the first and last name into this field for new customers.

BillingCompany

optional

string

Billing Address company name, if any, that needs to be updated. Up to 255 characters long.

BillingStreet

required

string

First line of billing street address that needs to be updated. Up to 255 characters long

BillingApartmentMailStop

optional

string

Billing apartment, mail stop or suite number that needs to be updated. Up to 255 characters long

BillingExtraAddress

optional

string

Last line of street address (only if necessary) associated with the credit card/payment method

BillingCity

required

string

Billing city name that needs to be updated. Up to 100 characters long

BillingRegion

conditional

string

Region associated with the credit card/payment method. For country_code=’USA’ or ‘CAN’, this must be the 2-character US state or Canadian code used by the postal service. Omeda also has region codes for other countries of the world.BillingRegion is required if BillingCountryCode is USA or Canada.

BillingPostalCode

conditional

string

Billing ZIP code or billing postal code. BillingPostalCode is required if BillingCountryCode is USA or Canada.

BillingCountryCode

required

string

3-character country code associated with the credit card/payment method

PayPalPaymentId

conditional

string

Required if PayPalPayerId is submitted. This is the unique paymentId associated with a PayPal payment. Note: PayPal payment credentials must be set up in Portal for this field to be used. Please speak with your account manager for further information. (coming soon 7/5/18)

PayPalPayerId

conditional

string

Required if PayPalPaymentId is submitted. This is the payerId (an id which belongs to a PayPal account) associated with a PayPal payment. Note: PayPal payment credentials must be set up in Portal for this field to be used. Please speak with your account manager for further information. (coming soon 7/5/18)

TelemarketingCompany

required

string

Name of Telemarketing Company, 100 char max

TelemarketingRecordingId

required

string

ID needed to locate recording, 50 char max

TelemarketingAgent

required

string

Name/ID of telemarketing agent, 20 char max

PersonalIdQuestion

required

string

Personal ID value provided by customer, 100 char max

TimeOfCall

optional

date

Time Call occurred (date/time).Two formats are available: yyyy-MM-dd and yyyy-MM-dd HH:mm.

EndOfCall

optional

date

Time Call ended (date/time).Two formats are available: yyyy-MM-dd and yyyy-MM-dd HH:mm.

LengthOfCall

optional

integer

Length of call in minutes

SpokeToName

required

string

Name of person the agent spoke to, 100 char max

SpokeToTitle

required

string

Title of person the agent spoke to, 100 char max

AuthorizedAssistantResponse

optional

boolean(true/false)

Was person spoke to authorized to make a product request (true/false)

GeneralTeleInfo

optional

string

Miscellaneous information, 255 char max

BehaviorId

Required

Omeda Event ID (Integer value)

BehaviorDate

Required

Date the behavior occurred (yyyy-MM-dd HH:mm:ss )

BehaviorPromoCode

optional

Promocode

MasterCard

5454545454545454

998

Future Date

Visa

4111111111111111

999

Future Date

MasterCard

5555555555554444

Any

Future Date

MasterCard

5105105105105100

Any

Future Date

Visa

4111111111111111

Any

Future Date

Visa

4012888888881881

Any

Future Date

American Express

378282246310005

Any

Future Date

American Express

371449635398431

Any

Future Date

Discover

6011111111111117

Any

Future Date

Discover

6011000990139424

Any

Future Date

MasterCard

5424000000000015

Any 3-digit

Future Date

Visa

4111111111111111

Any 3-digit

Future Date

Discover

6011000000000012

Any 3-digit

Future Date

American Express

370000000000002

Any 4-digit

Future Date

Diners Club/ Carte Blanch

38000000000006

Any 3-digit

Future Date

JCB

3088000000000017

Any 3-digit

Future Date

400 Bad Request

Typically, this error occurs when the request does not follow the specifications.

403 Forbidden

Typically, this error occurs when the credentials are erroneous. Potentially, an incorrect x-omeda-appid.

404 Not Found

Typically, this error occurs with a malformed URL or the resource that is searched for is not found.

405 Method Not Allowed

Typically, this error occurs when the resource accessed is not allowed by the HTTP Method utilized. Make sure you employ the correct HTTP Method (POST) for this request.