BeezUP Merchant API
The REST API of BeezUP system
Overview
The REST APIs provide programmatic access to read and write BeezUP data. Basically, with this API you will be able to do everything like you were with your browser on !
The main features are:
- Register and manage your account
- Create and manage and share your stores with your friends/co-workers.
- Import your product catalog and schedule the auto importation
- Search the channels your want to use
- Configure your channels for your catalogs to export your product information:
- cost and general settings
- category and columns mappings
- your will be able to create and manage your custom column
- put in place exlusion filters based on simple conditions on your product data
- override product values
- get product vision for a channel catalog scope
- Analyze and optimize your performance of your catalogs on all yours channels with different type of reportings by day, channel, category and by product.
- Automatize your optimisation by using rules!
- And of course... Manage your orders harvested from all your marketplaces:
- Synchronize your orders in an uniformized way
- Get the available actions and update the order status
- ...and more!
Authentication credentials
The public API with the base path /v2/public have been put in place to give you an entry point to our system for the user registration, login and lost password. The public API does not require any credentials. We give you the some public list of values and public channels for our public commercial web site .
The user API with the base path /v2/user requires a token which is available on this page:
Things to keep in mind
API Rate Limits
- The BeezUP REST API is limited to 100 calls/minute.
Media type
The default media type for requests and responses is application/json. Where noted, some operations support other content types. If no additional content type is mentioned for a specific operation, then the media type is application/json.
Required content type
The required and default encoding for the request and responses is UTF8.
Required date time format
All our date time are formatted in ISO 8601 format: 2014-06-24T16:25:00Z.
Base URL
The Base URL of the BeezUP API Order Management REST API conforms to the following template.
All URLs returned by the BeezUP API are relative to this base URL, and all requests to the REST API must use this base URL template.
You can test our API on You can contact us on
- Homepage
- https://api.apis.guru/v2/specs/beezup.com/2.0.json
- Provider
- beezup.com
- OpenAPI version
- 3.0.0
- Spec (JSON)
- https://api.apis.guru/v2/specs/beezup.com/2.0/openapi.json
- Spec (YAML)
- https://api.apis.guru/v2/specs/beezup.com/2.0/openapi.yaml
Tools (228)
Extracted live via the executor SDK.
-
analyticsGlobal.analyticsIndexGet the Analytics API operation index
-
analyticsGlobal.analyticsStoreIndexGet the Analytics API operation index for one store
-
analyticsOptimisations.copyOptimisationCopy product optimisations between 2 channels
-
analyticsOptimisations.optimise/!\ WARNING /!\
Apply the operation on every product related to this request.
This operation is used at the bottom of the analytics page result. -
analyticsOptimisations.optimiseAll/!\ WARNING /!\
Apply the operation on every product related to this request.
This operation is used at the bottom of the analytics page result. -
analyticsOptimisations.optimiseByCategory/!\ WARNING /!\
This operation will reenable or disable products's category for every channel indicated in the body. -
analyticsOptimisations.optimiseByChannel/!\ WARNING /!\
Apply the operation on every product on this channel. -
analyticsOptimisations.optimiseByProduct/!\ WARNING /!\
This operation will reenable or disable this product for every channel indicated in the body. -
analyticsReports.deleteReportFilterDelete the report filter
-
analyticsReports.getReportFilterGet the report filter description
-
analyticsReports.getReportFiltersGet report filter list for the given store
-
analyticsReports.saveReportFilterSave the report filter
-
analyticsRules.createRuleRule creation
-
analyticsRules.deleteRuleDelete Rule
-
analyticsRules.disableRuleDisable rule
-
analyticsRules.enableRuleEnable rule
-
analyticsRules.getRuleGets the rule
-
analyticsRules.getRulesGets the list of rules for a given store
-
analyticsRules.getRulesExecutionsGet the rules execution history
-
analyticsRules.moveDownRuleMove the rule down
-
analyticsRules.moveUpRuleMove the rule up
-
analyticsRules.runRuleRun rule
-
analyticsRules.runRulesRun all rules for this store
-
analyticsRules.updateRuleUpdate Rule
-
analyticsStatistics.getStoreReportByCategoryGet the report by category
-
analyticsStatistics.getStoreReportByChannelGet the report by channel
-
analyticsStatistics.getStoreReportByDayGet the report by day for a StoreId
-
analyticsStatistics.getStoreReportByDayPerStoreGet the report by day for a StoreId
-
analyticsStatistics.getStoreReportByProductGet the report by product
-
analyticsTracking.getStoreTrackedClicksGet the latest tracked clicks
-
analyticsTracking.getStoreTrackedExternalOrdersGet the latest tracked external orders
-
analyticsTracking.getStoreTrackedOrdersGet the latest tracked orders
-
analyticsTracking.getStoreTrackingStatusClicks and orders are eventually consistent.
This operation gets the current state of projections for a store. -
analyticsTracking.getTrackingStatusClicks and orders are eventually consistent.
This operation gets the current global state of projections. -
catalogsAuto.autoConfigureAutoImportIntervalConfigure Auto Import Interval
-
catalogsAuto.autoDeleteAutoImportDelete Auto Import
-
catalogsAuto.autoGetAutoImportConfigurationGet the auto import configuration
-
catalogsAuto.autoPauseAutoImportPause Auto Import
-
catalogsAuto.autoResumeAutoImportResume Auto Import
-
catalogsAuto.autoScheduleAutoImportConfigure Auto Import Schedules
-
catalogsAuto.autoStartAutoImportStart Auto Import Manually
-
catalogsAuto.importationActivateAutoImportOnce you have made your fist manual catalog importation with success, you can call this operation to import it automatically. No parameter required, we know which one it is.
-
catalogsCatalog.catalogChangeCatalogColumnUserNameChange Catalog Column User Name
-
catalogsCatalog.catalogChangeCustomColumnExpressionChange custom column expression
-
catalogsCatalog.catalogChangeCustomColumnUserNameChange Custom Column User Name
-
catalogsCatalog.catalogComputeExpressionCompute the expression for this catalog.
-
catalogsCatalog.catalogDeleteCustomColumnDelete custom column
-
catalogsCatalog.catalogGetCatalogColumnsGet catalog column list
-
catalogsCatalog.catalogGetCategoriesGet category list
-
catalogsCatalog.catalogGetCustomColumnExpressionGet the encrypted custom column expression
-
catalogsCatalog.catalogGetCustomColumnsGet custom column list
-
catalogsCatalog.catalogGetProductByProductIdGet product by ProductId
-
catalogsCatalog.catalogGetProductBySkuGet product by Sku
-
catalogsCatalog.catalogGetProductsGet product list
-
catalogsCatalog.catalogGetRandomProductsWe will return 10 products randomly selected with all product values
-
catalogsCatalog.catalogSaveCustomColumnCreate or replace a custom column
-
catalogsCatalog.catalogStoreIndexThe operation will give you all the operations you will be able to do on this store for this API.
-
catalogsCatalog.importationGetManualUpdateLastInputConfigGet the last input configuration
-
catalogsGlobal.catalogGetBeezUpColumnsGet the BeezUP columns, this columns are used for mapping during the manual catalog importation process.
-
catalogsGlobal.catalogIndexThe operation will give you all the operations you will be able to do and all the LOV used in this API.
-
catalogsImportationCatalogInfo.importationConfigureCatalogColumnConfigure catalog column
-
catalogsImportationCatalogInfo.importationDeleteCustomColumnDelete Custom Column
-
catalogsImportationCatalogInfo.importationGetCustomColumnExpressionGet the encrypted custom column expression in this importation
-
catalogsImportationCatalogInfo.importationGetCustomColumnsGet custom columns currently place in this importation
-
catalogsImportationCatalogInfo.importationGetDetectedCatalogColumnsGet detected catalog columns during this importation.
-
catalogsImportationCatalogInfo.importationGetProductSampleGet the product sample related to this importation with all columns (catalog and custom)
-
catalogsImportationCatalogInfo.importationGetProductSampleCustomColumnValue/!\ Use this operation only when you just changed the custom column expression and you want to get a precise the property value. Otherwise use the operation Importation_GetProductSample which will give you all property values
-
catalogsImportationCatalogInfo.importationIgnoreColumnIgnore Column
-
catalogsImportationCatalogInfo.importationMapCatalogColumnMap catalog column to a BeezUP column
-
catalogsImportationCatalogInfo.importationMapCustomColumnMap custom column to a BeezUP column
-
catalogsImportationCatalogInfo.importationReattendColumnReattend Column
-
catalogsImportationCatalogInfo.importationSaveCustomColumnCreate or replace a custom column
-
catalogsImportationCatalogInfo.importationUnmapCatalogColumnUnmap catalog column
-
catalogsImportationCatalogInfo.importationUnmapCustomColumnUnmap custom column
-
catalogsImportationProcess.importationCancelCancel importation
-
catalogsImportationProcess.importationCommitCommit Importation
-
catalogsImportationProcess.importationCommitColumnsCommit columns
-
catalogsImportationProcess.importationConfigureRemainingCatalogColumnsThis operation should be used after you have mapped the required BeezUP Columns
-
catalogsImportationProcess.importationGetImportationMonitoringGet the importation status
-
catalogsImportationProcess.importationGetProductsReportImportation Get Products Report
-
catalogsImportationProcess.importationGetReportImportation Get Report
-
catalogsImportationProcess.importationGetReportingsGet the latest catalog importation reporting
-
catalogsImportationProcess.importationGetReportingsAllStoresGet the latest catalog importation reporting for all your stores
-
catalogsImportationProcess.importationStartManualUpdateStart Manual Import
-
catalogsImportationProcess.importationTechnicalProgressionGet technical progression
-
channelCatalogsCategories.configureChannelCatalogCategoryConfigure channel catalog category
-
channelCatalogsCategories.disableChannelCatalogCategoryMappingDisable a channel catalog category mapping
-
channelCatalogsCategories.getChannelCatalogCategoriesGet channel catalog categories
-
channelCatalogsCategories.reenableChannelCatalogCategoryMappingReenable a channel catalog category mapping
-
channelCatalogsColumnMappings.configureChannelCatalogColumnMappingsConfigure channel catalog column mappings
-
channelCatalogsExclusionFilters.configureChannelCatalogExclusionFiltersConfigure channel catalog exclusion filters
-
channelCatalogsExclusionFilters.getChannelCatalogExclusionFiltersGet channel catalog exclusion filters
-
channelCatalogsExportations.clearChannelCatalogExportationCacheClear the exportation cache
-
channelCatalogsExportations.getChannelCatalogExportationCacheInfoGet the exportation cache information
-
channelCatalogsExportations.getChannelCatalogExportationHistoryGet the exportation history
-
channelCatalogsGlobal.addChannelCatalogAdd a new channel catalog
-
channelCatalogsGlobal.deleteChannelCatalogDelete the channel catalog
-
channelCatalogsGlobal.getChannelCatalogGet the channel catalog information
-
channelCatalogsGlobal.getChannelCatalogFilterOperatorsGet channel catalog filter operators
-
channelCatalogsGlobal.getChannelCatalogsList all your current channel catalogs
-
channelCatalogsLegacyTrackingGlobal.getLegacyTrackingChannelCatalogGet the channel catalog configured to use legacy tracking format information
-
channelCatalogsLegacyTrackingGlobal.getLegacyTrackingChannelCatalogsList all your current channel catalogs configured to use legacy tracking format
-
channelCatalogsLegacyTrackingGlobal.migrateLegacyTrackingChannelCatalogMigrate a channel catalog to current tracking format
-
channelCatalogsProducts.exportChannelCatalogProductInfoListExport channel catalog product information list
-
channelCatalogsProducts.getChannelCatalogProductByChannelCatalogGet channel catalog products related to these channel catalogs
-
channelCatalogsProducts.getChannelCatalogProductInfoGet channel catalog product information
-
channelCatalogsProducts.getChannelCatalogProductInfoListGet channel catalog product information list
-
channelCatalogsProducts.getChannelCatalogProductsCountersGet channel catalog products' counters
-
channelCatalogsProductsOptimisation.disableChannelCatalogProductBy default a all your catalog products are exposed to the channel. You can disable a product by using this operation. /!\ In case of massive optimisation we recommand you to use the analytics api
-
channelCatalogsProductsOptimisation.reenableChannelCatalogProductBy default a all your catalog products are exposed to the channel. You can reenable a product by using this operation. /!\ In case of massive optimisation we recommand you to use the analytics api
-
channelCatalogsProductsOverrides.configureChannelCatalogProductValueOverrideCopyCopy channel catalog product value override
-
channelCatalogsProductsOverrides.deleteChannelCatalogProductValueOverrideDelete a specific channel catalog product value override
-
channelCatalogsProductsOverrides.getChannelCatalogProductValueOverrideCopyGet channel catalog product value override compatibilities status
-
channelCatalogsProductsOverrides.overrideChannelCatalogProductValuesOverride channel catalog product values
-
channelCatalogsSettings.configureChannelCatalogCostSettingsConfigure channel catalog cost settings
-
channelCatalogsSettings.configureChannelCatalogGeneralSettingsConfigure channel catalog general settings
-
channelCatalogsSettings.disableChannelCatalogDisable a channel catalog
-
channelCatalogsSettings.enableChannelCatalogEnable a channel catalog
-
channelsChannelsGlobal.getAvailableChannelsList all available channel for this store
-
channelsChannelsGlobal.getChannelCategoriesGet channel categories
-
channelsChannelsGlobal.getChannelColumnsGet channel columns
-
channelsChannelsGlobal.getChannelInfoGet channel information
-
customerAccount.activateUserAccountActivate the user account
-
customerAccount.changeEmailChange user email
-
customerAccount.changePasswordChange user password
-
customerAccount.getCreditCardInfoGet credit card information
-
customerAccount.getProfilePictureInfoGet profile picture information
-
customerAccount.getUserAccountInfoGet user account information
-
customerAccount.resendEmailActivationResend email activation
-
customerAccount.saveCompanyInfoChange company information
-
customerAccount.saveCreditCardInfoSave user credit card info
-
customerAccount.savePersonalInfoSave user personal information
-
customerAccount.saveProfilePictureInfoChange user picture information
-
customerAlerts.getStoreAlertsGet store's alerts
-
customerAlerts.saveStoreAlertsYou just have to send the alert you want to update, does not need all alerts. (PARTIAL UPDATE ACCEPTED)
-
customerContracts.createContractNow you are ready to create your contract. Before that, please ensure that you check the offer with the same request parameterts. /offers
-
customerContracts.deleteNextContractDelete your next contract
-
customerContracts.getBillingPeriodsGet billing periods conditions
-
customerContracts.getContractsGet contract list
-
customerContracts.getOfferGet the offer pricing then you can create your contract with the same request parameters. /v2/user/customer/contracts
-
customerContracts.getStandardOffersGet all standard offers
-
customerContracts.reactivateCurrentContractBy calling this operation you can re-enable the auto renewal.
-
customerContracts.terminateCurrentContractBy default your contract are automatically renew. By calling this operation you can disable the auto renewal.
-
customerFriends.getFriendInfoGet friend information
-
customerGlobal.getCustomerIndexThe index of all operations and LOV
-
customerInvoices.getInvoicesGet all your invoices
-
customerRights.getRightsGet store's rights
-
customerSecurity.logoutLog out the current user from go2
-
customerSecurity.zendeskTokenZendesk token - Generates a JWT token to access BeezUP restricted Help Center in SSO as described here:
-
customerShares.deleteStoreShareDelete a share of a store to another user
-
customerShares.getStoreSharesGet shares related to this store
-
customerShares.shareStoreShare a store to another user
-
customerStores.createStoreCreate a new store
-
customerStores.deleteStoreDelete a store
-
customerStores.getStoreGet store's information
-
customerStores.getStoresGet store list
-
customerStores.updateStoreUpdate some store's information. FYI, you cannot change the country.
-
marketplacesChannelCatalogsGlobal.getMarketplaceChannelCatalogsGet your marketplace channel catalog list
-
marketplacesChannelCatalogsPublications.getPublicationsFetch the publication history for an account, sorted by descending start date
-
marketplacesChannelCatalogsPublications.publishCatalogToMarketplace[PREVIEW] Launch a publication of the catalog to the marketplace
-
marketplacesChannelCatalogsSettings.getChannelCatalogMarketplacePropertiesGet the marketplace properties for a channel catalog
-
marketplacesChannelCatalogsSettings.getChannelCatalogMarketplaceSettingsGet the marketplace settings for a channel catalog
-
marketplacesChannelCatalogsSettings.setChannelCatalogMarketplaceSettingsAllow you to configure your marketplace settings. Partial update accepted.
-
marketplacesOrdersAutoTransitions.configureAutomaticTransitionsConfigure new or existing automatic Order status transition
-
marketplacesOrdersAutoTransitions.getAutomaticTransitionsGet list of configured automatic Order status transitions
-
marketplacesOrdersBatches.changeOrderListThe purpose of this operation is to reduce the amount of request to the API. Max 100 items per call.
-
marketplacesOrdersBatches.clearMerchantOrderInfoListThe purpose of this operation is to reduce the amount of request to the API.
-
marketplacesOrdersBatches.setMerchantOrderInfoListThe purpose of this operation is to reduce the amount of request to the API.
-
marketplacesOrdersExports.exportOrdersA new file will be generated containing a summary of all the Orders matching the requested filter settings.
-
marketplacesOrdersExports.getOrderExportationsGet a paginated list of Order report exportations
-
marketplacesOrdersGlobal.getMarketplaceAccountsSynchronizationUse /orders/v3
-
marketplacesOrdersGlobal.getOrderIndex[DEPRECATED] Get all actions you can do on the order API
-
marketplacesOrdersGlobal.harvestAll[DEPRECATED] Send harvest request to all your marketplaces
-
marketplacesOrdersList.getOrderListFullDEPRECATED - Use /orders/v3 instead The purpose of this operation is to reduce the amount of request to the API.
Previous implmentation of this feature only returned a partial (light) version of the Orders. The purpose of this API is to reduce the number of incoming requests by returning the complete (full) Order and Order Item(s) properties. -
marketplacesOrdersList.getOrderListLightUse /orders/v3 instead
-
marketplacesOrdersOrder.changeOrder[DEPRECATED] Change your marketplace Order Information (accept, ship, etc.)
-
marketplacesOrdersOrder.clearMerchantOrderInfo[DEPRECATED] Clear an Order's merchant information
-
marketplacesOrdersOrder.getOrderDEPRECATED - Use /orders/v3 instead
-
marketplacesOrdersOrder.getOrderHistory[DEPRECATED] Get an Order's harvest and change history
-
marketplacesOrdersOrder.harvestOrder[DEPRECATED] Send harvest request for a single Order
-
marketplacesOrdersOrder.headOrderDEPRECATED - Use /orders/v3 instead The purpose of this operation is to reduce the bandwith usage by getting just the meta information about the order (ETag, Last-Modified) with the body. This could be useful
-
marketplacesOrdersOrder.setMerchantOrderInfo[DEPRECATED] Set an Order's merchant information
-
marketplacesOrdersSubscriptionsSubscriptions.activateSubscriptionAt this moment, BeezUP will ensure that your callback url is respecting this specification:
After that we will send you the orders related to your subscription, respecting this specification:
-
marketplacesOrdersSubscriptionsSubscriptions.createSubscriptionPlease take a look at this sequence diagram to understand the subscription process to follow
-
marketplacesOrdersSubscriptionsSubscriptions.deactivateSubscriptionDeactivate a subscription to the orders
-
marketplacesOrdersSubscriptionsSubscriptions.deleteSubscriptionDelete a subscription to the orders
-
marketplacesOrdersSubscriptionsSubscriptions.getSubscriptionGet a subscription to the orders
-
marketplacesOrdersSubscriptionsSubscriptions.getSubscriptionListGet the subscription list
-
marketplacesOrdersSubscriptionsSubscriptions.getSubscriptionPushReportingGet the push reporting related to this subscription
-
marketplacesOrdersSubscriptionsSubscriptions.retryPushOrdersIn case your subscription consumption is unavailable and your subscription is still active you can ask to retry immediatly to push orders instead of waiting the next scheduled retry date
-
marketplacesOrdersV3Batches.changeOrderListV2The purpose of this operation is to reduce the amount of request to the API. Max 100 items per call.
-
marketplacesOrdersV3Batches.changeOrderListV3The purpose of this operation is to reduce the amount of request to the API. Max 100 items per call.
-
marketplacesOrdersV3Batches.clearMerchantOrderInfoListV3The purpose of this operation is to reduce the amount of request to the API.
-
marketplacesOrdersV3Batches.setMerchantOrderInfoListV3The purpose of this operation is to reduce the amount of request to the API.
-
marketplacesOrdersV3Global.getMarketplaceAccountsSynchronizationV3Get current synchronization status between your marketplaces and BeezUP accounts
-
marketplacesOrdersV3Global.getOrderManagementReadyMarketplaceBusinessCodeGet the list of MarketplaceBusinessCode ready for Order Management
-
marketplacesOrdersV3Global.harvestAllV3Send harvest request to all your marketplaces
-
marketplacesOrdersV3List.getOrderListFullV3The purpose of this operation is to reduce the amount of request to the API.
Previous implmentation of this feature only returned a partial (light) version of the Orders. The purpose of this API is to reduce the number of incoming requests by returning the complete (full) Order and Order Item(s) properties. -
marketplacesOrdersV3List.getOrderListLightV3Get a paginated list of all Orders without details
-
marketplacesOrdersV3Order.changeOrderV3Change your marketplace Order Information (accept, ship, etc.)
-
marketplacesOrdersV3Order.clearMerchantOrderInfoV3Clear an Order's merchant information
-
marketplacesOrdersV3Order.getOrderChangeReportingV3This operation will help you to know the status of your order change operation
-
marketplacesOrdersV3Order.getOrderHistoryV3Get an Order's harvest and change history
-
marketplacesOrdersV3Order.getOrderV3Get full Order and Order Item(s) properties
-
marketplacesOrdersV3Order.harvestAccountSend harvest request for an Account
-
marketplacesOrdersV3Order.harvestOrderV3Send harvest request for a single Order
-
marketplacesOrdersV3Order.headOrderV3The purpose of this operation is to reduce the bandwith usage by getting just the meta information about the order (ETag, Last-Modified) with the body. This could be useful
-
marketplacesOrdersV3Order.setMerchantOrderInfoV3Set an Order's merchant information
-
omInvoiceApiGeneration.generateBatchOrderInvoiceGenerate an Order Invoice batch
-
omInvoiceApiGeneration.generateOrderInvoiceGenerate an Order Invoice
-
omInvoiceApiGeneration.getOrderInvoicePdfReturns the PDF version of the invoice
-
omInvoiceApiGeneration.getOrderInvoicePreviewView a preview an Order Invoice
-
omInvoiceApiSettings.getOrderInvoiceDesignSettingsGet Order Invoice design settings
-
omInvoiceApiSettings.getOrderInvoiceDesignSettingsPreviewView a preview an Order Invoice using custom design settings
-
omInvoiceApiSettings.getOrderInvoiceGeneralSettingsGet Order Invoice general settings
-
omInvoiceApiSettings.saveOrderInvoiceDesignSettingsSave Order Invoice design settings
-
omInvoiceApiSettings.saveOrderInvoiceGeneralSettingsSave Order Invoice general settings
-
publicChannelsPublicChannels.getChannelsThe channel list for one country
-
publicChannelsPublicChannels.getChannelsIndexUse this operation to get the correct link to the channels and to the list of values
-
publicListOfValuesLov.getPublicListOfValuesGet the list of values related to this list name
-
publicListOfValuesLov.getPublicLovIndexGet all list names
-
publicSecuritySecurity.loginUser Login - The login will give your tokens
-
publicSecuritySecurity.lostPasswordLost password - Your password will be regenerated and sent to your email
-
publicSecuritySecurity.registerUser Registration - Create a new user on BeezUP
-
userListOfValuesLov.getUserListOfValuesGet the list of values related to this list name
-
userListOfValuesLov.getUserLovIndexGet all list names
-
openapi.previewSpecPreview an OpenAPI document before adding it as a source
-
openapi.addSourceAdd an OpenAPI source and register its operations as tools