AccessScope resources are used by merchants to authorize apps.

Each permission point is associated with a series of Open APIs. Through these Open APIs, apps can access or edit store data.

This document lists the currently available AccessScope permission points on the platform and their associated interfaces.

You should determine which permissions to apply from the merchant when installing or updating the app based on your actual needs.

For example, if an app needs to query the merchant’s order information during use, it needs to request the read_orders permission from the merchant during installation.

After merchant authorization, SHOPLINE will return an access token containing AccessScope information. When the app makes a request with the access token, only interfaces that meet the scope of the AccessScope can be successfully returned.

AccessScope​

write_selling_plan_group​

Permission point description: Modify selling plan group
Related interface: Add Product to sales plan group、Tie-downs from the sales plan group Product、Delete sales plan group、Create a sales plan group、Update sales plan group
Apply to private application: false

write_subscription_contracts​

Permission point description: Modify subscription contracts and payment methods
Related interface: Skip the next bill、Create your order as soon as your subscription contract is created、Revise next bill time、Cancel subscription contract、Edit subscription contract information
Apply to private application: false

write_files​

Permission point description: Modify store information and manage multimedia resources
Related interface: Create File、Update Files、Delete Files
Apply to private application: true

read_script_tags​

Permission point description: Access the JavaScript code in storefront or orders status pages
Related interface: Query script tag list、Query a single script tag、Query the number of script tags
Apply to private application: true

write_orders​

Permission point description: Modify orders, transactions, fulfillments, and abandoned checkouts
Related interface: Update tracking number、Update payment slip、Query payment settings、Delete all risk fraud related to the order、Add risk fraud、Remove the specify of the order risk fraud、Update order risk fraud、Order refund trial、Create an order、Cancel order、Update order、Order refund、Create payment slip、Order shipped、Cancel shipping
Apply to private application: true

write_script_tags​

Permission point description: Modify JavaScript codes in storefront or orders status pages
Related interface: Create a script tag、Update script tag、Delete script tag
Apply to private application: true

read_gift_card​

Permission point description: Access gift cards and coupon codes
Related interface: Query single gift card、Query number of gift cards、Paging query gift card
Apply to private application: true

read_content​

Permission point description: Access articles, blogs, and comments, and redirect traffic
Related interface: Query blog collection list、Query blog post list、Query list of all articles authors、Query blog post details、Query blog post、Query blog collection quantity、Query single blog collection、Get theme list in bulk、Query one theme、By reviewing id query comments、Number of get the comments、Query list of comments
Apply to private application: true

read_subscription_contracts​

Permission point description: Access subscription contracts and payment tools
Related interface: Query subscription contract details、Query subscription contract list
Apply to private application: false

write_shop_policy​

Permission point description: Modify shop policy
Related interface: Update a store policy page
Apply to private application: true

write_bulkoperation​

Permission point description: Manage bulkoperation
Related interface: Bulk operation mutation（Deprecated）、Bulk operation query、Batch mission update ( generic )、Bulk mission cancellation
Apply to private application: true

read_price_rules​

Permission point description: Access pricing and allocations
Related interface: Retrieve all price rules counts、Retrieve individual price rules
Apply to private application: true

read_markets​

Permission point description: Access market information
Related interface: Query market list、Returns a market resource by ID
Apply to private application: true

write_customers​

Permission point description: Modify customer information, customer addresses, order history, and customer groups
Related interface: Create customer grouping、Update customer grouping、Delete customer grouping、Delete customer information、Send activation mail、Activate the customer、Batch address、Add address 2.0、Update address 2.0、Set default address 2.0、Delete customer address 2.0、Delete specify customer tag、Create a customer、Update customer information
Apply to private application: true

read_products​

Permission point description: Access products, variants, and collections
Related interface: Batch query product quantity、Query all SKUs quantity of single product、Query manual collection attributes by ID、Batch query manual collection quantity、Batch query intelligent collection quantity、Batch query manual collection、Single query collection relationship、Batch query collection relationship、Batch query collection relationship quantity、List of resources feedback、Bulk query products、Query single product、Query all SKUs of single product、Query SKU by ID、Query single Product image、Batch query Product images、Query main image total number for single Product、Query product information in a certain collection、Query collection information by ID、Query intelligent collection attributes by ID、Batch query intelligent collection
Apply to private application: true

read_shipping​

Permission point description: Access shipping information and local tax rates
Related interface: Query inventory address、Query all pickup information、Query all local shipping information、Query country number of tax already configured in stores、Query specify tax information from the country、Query all tax information in the store、Query quantity of all state provinces in a country、Query specify all state province information under the country、Query state province information、Receive a list of all CarrierServices、Receive a single CarrierService
Apply to private application: true

read_discounts​

Permission point description: Manage automatic discounts and discount codes
Related interface: Query automatic discount activity、Query discount code、Query DiscountCode by ID、Query DiscountCode by Code、Query DiscountCode by discount rules ID、Query store's total number of DiscountCode、Based on mission id query promo code information、Query bulk created discount code list、Retrieve price rules list
Apply to private application: true

write_markets​

Permission point description: Modify market information
Related interface: Market currency update
Apply to private application: true

read_selling_plan_group​

Permission point description: Access selling plan group
Related interface: Query sales program group details、Query multiple selling programs、Get the sales plan group total number
Apply to private application: false

read_draft_orders​

Permission point description: Manage the orders that merchants created for customers
Related interface: Draft order quantity query、Query draft order
Apply to private application: true

write_discounts​

Permission point description: Modify automatic discounts and discount codes
Related interface: Create DiscountCode、Delete DiscountCode、Update DiscountCode、Create promo code created tasks、Create PriceRule
Apply to private application: true

read_themes​

Permission point description: Access themes, theme templates, and assets
Related interface: Query theme asset list、Query theme asset details
Apply to private application: true

write_store_information​

Permission point description: Modify store information and langauge
Related interface: Add store language settings
Apply to private application: true

read_store_metrics​

Permission point description: Access store metrics, transactions, customer behavior
Related interface: Query the effective plan of the store
Apply to private application: true

write_price_rules​

Permission point description: Modify conditional discounts
Related interface: Delete existing price rule、Update existing price rule
Apply to private application: true

read_assigned_fulfillment_orders​

Permission point description: Access assigned fulfillment orders and logistics tracking
Related interface: Get specify fulfillment order、Query number of fulfillment、Get all of the order-placed fulfillment order、Get all fulfillments for the fulfillment order、Query all fulfillments for an order、Get specify fulfillment under fulfillment order
Apply to private application: true

read_payment​

Permission point description: Access payment and account balances
Related interface: Balance、Payouts、Balance transactions、Payout
Apply to private application: true

read_marketing_event​

Permission point description: Access and create marketing event
Related interface: Query individual marketing events、Query number of marketing events、Query marketing events list
Apply to private application: true

read_translation​

Permission point description: Access translation
Related interface: Get store language settings、Query store translation data in bulk、Query UGC corpuses
Apply to private application: true

write_content​

Permission point description: Modify articles, blogs, and comments, redirect traffic
Related interface: Delete blog post、Update blog post、Update blog collection、Delete blog collection、Update theme、Delete theme、Create a redirect、Get a list of redirect、Query single redirect details、Statistical redirect quantity、Update redirect、Remove a redirect、Create a comment、Update comments、Approve the comment、Labeled comments as non spam、Labeled comments as spam、Delete a comment、Comment for recovery delete、Create blog articles for the collection、Create a blog collection
Apply to private application: true

read_returns​

Permission point description: Access returns and return orders
Related interface: Query returns、Query Return Fulfillment Order、Query Return Fulfillment
Apply to private application: true

read_files​

Permission point description: Manage store information and manage multimedia resources
Related interface: View individual files、Batch query files
Apply to private application: true

write_gift_card​

Permission point description: Modify gift card codes and related messages
Related interface: Create gift cards、Update gift card、Disable gift card
Apply to private application: true

read_store_information​

Permission point description: Access account langauge and store information
Related interface: Query store information、Query store payment channels
Apply to private application: true

read_orders​

Permission point description: Access orders, transactions, fulfillments, and abandoned checkouts
Related interface: Query abandoned order、Query store settlement currency、Query order risk fraud list、Query risk fraud for order specify、Query all refund orders for the id association、Query order specify of your money back order、Retrieves a count of checkouts、Order quantity query、Retrieves a list of transactions、Query orders
Apply to private application: true

read_shop_policy​

Permission point description: Access shop policies
Related interface: Query policy page information
Apply to private application: true

write_marketing_event​

Permission point description: Edit marketing events
Related interface: Process Statistics Synchronization、Create marketing events、Mass sync marketing event statistics、Update marketing events、Delete marketing events、Create marketing expansion、Update marketing expansion
Apply to private application: true

read_page​

Permission point description: Access page
Related interface: Query page's detail information、Get a custom page list、Count the number of custom pages
Apply to private application: true

write_return​

Permission point description: Modify returns and return fulfillments
Related interface: Close Return、Create a Return、Create a Return Fulfillment、Update logistics information for a Return Fulfillment
Apply to private application: true

write_translation​

Permission point description: Modify translated content
Related interface: Delete store language、Delete corpuses based on resource IDs and field、Update UGC corpuses
Apply to private application: true

write_products​

Permission point description: Modify products, variants, and collections
Related interface: Create manual collection、Update manual collection、Delete manual collection、Delete intelligent collection、Delete product、Create binding relationship、Delete binding relationship、Delete SKU、Resources feedback、Update product、Create product、Create SKU、Update SKU by ID、Update Product images、Delete Product images、Create Product images、Create smart collection、Update smart collection
Apply to private application: true

read_location​

Permission point description: Access locations and logistical setups
Related interface: Based on id query location、Query location list、Statistics number of locations
Apply to private application: true

write_shipping​

Permission point description: Modify shipping service provider settings and local tax fees
Related interface: Create a new CarrierService、Modify an existing CarrierService、Remove an existing CarrierService、Batch shipping plan
Apply to private application: true

read_bulkoperation​

Permission point description: Access bulk operations and status
Related interface: Query active tasks in current stores
Apply to private application: true

write_product_listings​

Permission point description: Manage product lists
Related interface: Remove collection from sales channels、Query sales channels specify collection Product id、Remove from sales channels Product、Add Product to sales channels、Add collection to sales channels
Apply to private application: true

read_inventory​

Permission point description: Access inventory across multiple locations
Related interface: Batch query inventory status、Get a single inventory object、Batch query inventory object
Apply to private application: true

write_draft_orders​

Permission point description: Modify orders created by merchants on behalf of customers
Related interface: Send invoice link、Delete draft order、Complete draft order、Create draft order、Edit draft order
Apply to private application: true

read_pos​

Permission point description: Access POS
Related interface: Query store list
Apply to private application: false

write_page​

Permission point description: Modify page and custom messaging
Related interface: Delete custom pages、Add custom pages、Update custom page
Apply to private application: true

write_inventory​

Permission point description: Modify inventory and related messages across multiple locations
Related interface: Update inventory status、Set inventory status、Connect stock status、Disconnect stock status、Update inventory object
Apply to private application: true

read_product_listings​

Permission point description: Access product entries
Related interface: Query Product id for sales channels、Query Product total number for sales channels、Query Product of sales channels、Query specify Product for sales channels、Query collection of sales channels、Query specify collection in sales channels
Apply to private application: true

write_themes​

Permission point description: Modify themes, theme templates, and assets
Related interface: Create / modify theme asset、Delete theme asset、Create theme
Apply to private application: true

write_assigned_fulfillment_orders​

Permission point description: Manage assigned fulfillment orders
Related interface: Set up a fulfillment order deadline、Update inventory location for fulfillment order、Re-book the date of the sale、Fulfillment order release onhold status、Performance appointment marker onhold、Update fulfillment tracking information、Create an fulfillment for the fulfillment order ( single or batch )、Cancel fulfillment
Apply to private application: true

write_payment_gateways​

Permission point description: Modify payment gateways
Related interface: Refund successful notification、Payment successful notice、Merchant activation successful notification
Apply to private application: false

read_customers​

Permission point description: Manage customers, customer addresses, order history, and customer groups
Related interface: Specify customer grouping query、Get customer grouping in bulk、Customer number query、Query all customers in groups、Batch query user subscription information、Query store grouping、Query specify customer order、Customer list、Customer details、Query customer address details 2.0、Batch query customer address 2.0、Check customer information via email、Customer information list query、Query customer details、Customer information retrieval
Apply to private application: true

Unanthenticated AccessScope​

unauthenticated_read_checkouts_info​

Permission point description: Access product sales and checkout info via Storefront
Related interface: checkout
Apply to private application: true

unauthenticated_write_checkouts_info​

Permission point description: Update checkout info via Storefront
Related interface: checkoutShippingAddressUpdate
Apply to private application: true

unauthenticated_write_customer_information​

Permission point description: Modify customer information and address via Storefront
Related interface: customerAccessTokenCreate
Apply to private application: true