compliance API1.3.0

ComplianceDetail

This type is used by each listing violation that is returned under the violations container.

Type that uses ComplianceDetail

Call that uses ComplianceDetail

Fields

Field
Type
Description
reasonCode

This value states the nature of the listing violation. A reasonCode value is returned for each listing violation, and each compliance type can have several reason codes and related messages. The reasonCode values vary by compliance type. The reason codes for each compliance type are summarized below.

Aspects adoption

The ASPECTS_ADOPTION reason codes indicate that for the given violation, aspects listed in the violationData container are either missing from the listing or they have invalid values. The reason codes specify whether the violation is for required aspects or recommended (preferred) aspects.

  • MISSING_OR_INVALID_REQUIRED_ASPECTS
  • MISSING_OR_INVALID_PREFERRED_ASPECTS

HTTPS

The HTTPS reason codes identify where in the listing the violation occurs. For HTTPS policy violations, the seller will just need to remove the HTTP link (or update to HTTPS) from the listing details or product details:

  • NON_SECURE_HTTP_LINK_IN_LISTING
  • NON_SECURE_HTTP_LINK_IN_PRODUCT

Non-eBay links

The OUTSIDE_EBAY_BUYING_AND_SELLING reason codes identify the specific type of data (e.g., telephone number) that violated the policy. For each of these violations, the seller will just need to remove this information with a revise listing call:

  • UNAPPROVED_DOMAIN_WEBLINK_IN_LISTING
  • PHONE_NUMBER_IN_LISTING
  • EMAIL_ADDRESS_IN_LISTING

Product adoption

Product Adoption is not enforced at this time.

Product adoption conformance

Product Adoption is not enforced at this time.

Returns policy

The only RETURNS_POLICY reason code is UNSUPPORTED_RETURNS_PERIOD. The seller will have to revise their listing (or return business policy) with a supported return period for the site and category.

message
This field provides a textual summary of the listing violation. A message field is returned for each listing violation. This message will vary widely based on the compliance type and corresponding reason code.
variation
This container defines the variation within a multiple-variation listing that has the listing violation. This container is only returned if an individual variation within a multiple-variation listing has the listing violation.
violationData
array of NameValueList
This container providee more information about the listing violation, if applicable. The type of information that appears here will vary based on the compliance type and type of violation. For example, for Aspect Adoption violations, this container lists the missing aspects or aspects with invalid values.
correctiveRecommendations
This container is returned if eBay has found an eBay Catalog product that may be a match for the product (or product variation) that has a listing violation.

Note: Product Adoption is not enforced at this time. Product Adoption violations are no longer returned.
complianceState
This property indicates the severity of the given policy violation for a listing. Generally, OUT_OF_COMPLIANCE policy violations can prevent the seller from revising a listing until the underlying violation(s) can be remedied. When the compliance state is AT_RISK, the seller is not blocked from revising the listing, but the seller should correct the violation to prevent the listing from bing blocked for revisions in the future.

This field is not returned for all violations. The default value, when not returned, is OUT_OF_COMPLIANCE.

Applicable values:

    • OUT_OF_COMPLIANCE
    • AT_RISK