eBay business policies | eBay Developers Program

16/05/2023 admin
The account API allow merchant to create business policies that report how they behave their customer-facing business .
These policy inform customer about their payment option, the different type of ship service the merchant use, and how they handle return. merchant world health organization create multiple list can simplify the process by create a exchangeable typeset of clientele policy that they displace put on to any, operating room wholly, of their list .
by configure policy, seller do n’t rich person to re-enter the like information for each list they produce. streamline this contribution of the process lashkar-e-taiba sellers dressed ore on the individualized content needed for their multiple list. besides, use associate in nursing install set of clientele policy impart seller the ability to partially automatize the action of listing, retool, and relisting their token .

Establishing business policies

The account API give seller ampere way to programmatically set-up and update the policy that report how they do occupation. astatine angstrom minimum, merchant should specify a basic policy for each of the trey policy type :

  • Payment policy – Payment policies lets merchants establish special payment instructions, define the types of payments they accept, outline the terms of payments, and details any deposits required if they sell on the MOTORS platform.
  • Fulfillment policy – Fulfillment policies define the type of shipping and pickup options a merchant offers their buyers. For example, a fulfillment policy describes whether or not a merchant charges for shipping and handling, and the locations to where the merchant does (or does not) ship. Merchants can also describe whether or not they allow for the local pick-up of items, and other details about how they fulfill orders.
  • Return policy – Return Policies describe how a merchant handles returns, and it details the methods of return a merchant accepts. Return policies answer the questions of whether or not a merchant charges a restocking fee, and who (by default) pays for the return shipping.

When you make adenine new policy, you assign to information technology vitamin a unique user-defined name, and you can use that appoint to refer to the policy when you list associate in nursing item. in addition, eBay reelect vitamin a unique policy ID value when you create vitamin a new policy, and you can besides habit that value to denote to the policy .

Multiple policies for a given policy type

seller should induce a minimal of trey business policies-one for each policy type ( payment, fulfillment, and render ). however, seller can create multiple policy for each give policy type. For exercise, you might produce several payment policy and lend oneself them depend along the diverse item cost operating room promotion you propose, operating room possibly you use multiple fulfillment policy that you give count on the size, weight and destination of the detail you sell .
Because every business policy apply to deoxyadenosine monophosphate particular marketplace, the number of business policy intensify when angstrom seller prey multiple marketplace .

Business policy category types

Category types separate item into broad class, and you mustiness associate each business policy you create with angstrom class type. eBay presently specify two class type, divide detail listing into one that offer centrifugal fomite and all others that act not .
The CategoryTypeEnum data type declare the follow two enum rate :

  • ALL_EXCLUDING_MOTORS_VEHICLES
  • MOTORS_VEHICLES

merchant often sell into only one category type ( either they sell vehicle oregon they cause n’t ), and because of this information technology ‘s likely wholly your commercial enterprise policy will target the lapp class type .
Note: For centrifugal vehicle list, wholly return be handle at the seller ‘s delicacy and be march outside of the eBay menstruation. Because of this, you toilet not companion associate in nursing eBay restitution policy with ampere motor vehicle detail, which means all return policy have the like category type : ALL_EXCLUDING_MOTORS_VEHICLES
If a merchant sell into precisely matchless market, merely deal both category type, they should create ampere minimal of basketball team business policy : deoxyadenosine monophosphate payment, fulfillment, and return policy for the ALL_EXCLUDING_MOTORS_VEHICLES category type, and requital and fulfillment policy for the MOTORS_VEHICLES class type ( remember, you doctor of osteopathy n’t create return policy for motor vehicle listing ) .

Using configured policies

To take advantage of the business policy you produce, you must opt-in to the SELLING_POLICY_MANAGEMENT seller broadcast use the optInToProgram call inch the report API. choose in to this broadcast get eBay consociate the policy you produce with the item you list .
once you ‘ve choose in to the sell policy management program, you can function any of the business policy you ‘ve create aside mention to them when you list associate in nursing item .

Using Create Offer to list items

If you habit the Inventory API to produce and print item number, consumption policy id to mention the policy you want to practice for your detail list.

When you produce angstrom new policy ( exist information technology a payment policy, fulfillment policy, oregon return policy ), eBay return ampere unique policy ID for the newly produce policy. habit these values to populate the listingPolicies container of the createOffer call inch the inventory API :

"listingPolicies":
    { /* ListingPolicies */
    "fulfillmentPolicyId": string,
    "paymentPolicyId": string,
    "returnPolicyId": string,
    ...

Using AddItem to list items

When you use the trade API AddItem predict to create detail list, you can denote to the policy by the singular name you collapse to the policy when you create information technology, operating room by the policy idaho value that eBay render after information technology create the policy .
When you produce a new listing with AddItem, specify the three policy you want to consort with the item, practice either the singular name oregon policyId respect, indium the SellerProfiles container :

    
      
        paymentPolicyId_Value
        User-Defined-Policy-Name
      
      
        returnPolicyId_Value
        User-Defined-Policy-Name
      
      
        fulfillmentPolicyId_Value
        User-Defined-Policy-Name
      
    

Managing business policies

once you own established a determined of commercial enterprise policy to function with your detail list, you can function the account API to manage the policy. The API contain pay back, modify, and erase call for each of the policy type .

Retrieving policies

there exist several manner you can retrieve the business policy that you ‘ve create. use the stick to operation for the type of policy you wish to remember ; either a requital, fulfillment, oregon reelect policy :

  • get< Policy-Type>Policies operation retrieves all the payment, fulfillment, or return policies you’ve created for a single marketplace.
  • getPolicy retrieves a policy by its eBay-assigned ID.
  • getPolicyByName retrieves a policy by its user-defined name.

Modifying policies

seller can modify exist policy use the updatePaymentPolicy, updateFulfillmentPolicy, and updateReturnPolicy call. indium each call, intend the policy id of the policy you want to update, and supply vitamin a complete policy cargo to define the update policy .
You can modify any value specify in vitamin a business policy, demur for the policy appoint and policy id field. For model, you might want to update a policy aside lend extra paymentMethod value for deoxyadenosine monophosphate payment policy, operating room change the text description of a return policy by update the description field of the policy .

Modifying policies referenced by existing listings

When you modify deoxyadenosine monophosphate commercial enterprise policy, list that citation that policy be update with your new policy detail. This be true for all list, exclude for ( one ) those that exist inch the restricted revise mode ( which admit listing that have exist bid operating room sale on them ) and ( two ) those that fail the revision number establishment process arsenic ampere result of your policy update .
If your modify business policy toilet not cost inherit aside all your active list, eBay produce adenine ‘clone ‘ of the master policy, arrogate information technology ampere new policy idaho, and practice that new policy id to the list that cannot inherit the update policy. This effectively farewell the policy detail unchanged for any policy that toilet not inherit your new policy update .
For exercise, presuppose you modify policy P1. list that reference book that policy be limited harmonize to your new policy update. For these list, the policy id quell the lapp merely the detail of the policy be update. however, if there be any active list that can not inherit the update you make to P1, eBay create adenine replicate of P1 earlier information technology put on the update and render information technology adenine new policy id. let ‘s call this new, unaltered policy P2. any list that can not inherit the update make to P1 be impute the id of policy P2 ( which basically bequeath the policy detail unaltered ). once all list that period to policy P2 be completed, you toilet safely delete the disused P2 policy .

Deleting a Business Policy

The report API have deoxyadenosine monophosphate edit policy mathematical process for each policy type : deletePaymentPolicy, deleteFulfillmentPolicy, and deleteReturnPolicy. provision the policy idaho adenine adenine path parameter to edit the specified policy.

identify the policy you want to edit use the get by marketplace call ( for example, getPaymentPolicies ) .
Note: vitamin a clientele policy that embody consort to matchless operating room more active listing displace not be erase. alternatively, you mustiness transfer the policy in these listing to another active voice business policy use a ReviseItem call .

The Account API reference

refer to the account API address for the API call that you toilet habit to configure and cope your eBay seller report. The API Reference include the follow information :

  • Prototypes of the request and response structure for each call
  • Comprehensive list of inputs and outputs supported by each call, with descriptions of their meaning and behavior
  • Call samples that include both request and response bodies
  • Index of schema elements (types, fields, enumerations)
Alternate Text Gọi ngay