API Integrations

SKUBIQ API OverView

Discover how to leverage SKUBIQ Public API to build integrations.

Utilizing SKUBIQ Public API for Integrations

A SKUBIQ workspace is a collaborative environment where teams can organize work, manage projects, and store information in a highly customizable way. SKUBIQ’s REST API facilitates direct interactions with workspace elements through programming. Key functionalities include:

Sale Order : Create, update, and retrieve page content.
Purchase Order : Manage database, properties, entries, and schemas.
Item Master : Access user profiles and permissions.
Inward Import : Handle page and inline comments.
Outward Import : Search through workspace content.

To make interactions within SKUBIQ workspaces programmatically, you must associate these actions with a SKUBIQ user. SKUBIQ facilitates this by allowing API requests to be linked to a “bot” user.

Developers create integrations to define a bot’s capabilities, including authenticating API requests, deciding when to make requests, and setting the bot’s read/write permissions. Essentially, using SKUBIQ’s Public API involves creating an integration that outlines how a bot interacts with your workspace and assigns REST API requests to the bot.

There are two primary integration types:

  • Internal: For private workspace enhancements.
  • Public: For broader, shareable functionalities, including Link Previews.

For further details on integration possibilities and API specifics, proceed with the guide or consult the API reference. Check out our demos for practical examples.

What is a SKUBIQ Integration?

A SKUBIQ integration, sometimes referred as a connection, enables developers to programmatically interact with SKUBIQ workspaces. These integrations facilitate linking SKUBIQ workspace data with other applications or the automation of workflows within SKUBIQ.

Integrations are installed in SKUBIQ workspaces and require explicit permission from users to access SKUBIQ pages and databases.

SKUBIQ users have access to a vast library of existing integrations to enrich their experience further. For developers interested in creating custom solutions, SKUBIQ supports the development of both internal and public integrations. Both utilize the SKUBIQ API for workspace interactions.

Let’s explore internal and public integrations.

Internal vs. Public Integrations

SKUBIQ integrations come in two types: Internal and Public. Understanding the differences between them helps in choosing the right approach for your development needs.

Feature
Internal Integrations
Public Integrations
Scope
Confined to a single, specific workspace.
Available across multiple, unrelated workspaces.
User Access
Only accessible by members of the workspace where it’s installed.
Accessible by any SKUBIQ user, regardless of their workspace.
Creation
Created by Workspace Owners within the integration dashboard.
Created by Workspace Owners within the integration dashboard.
Permissions
Workspace members explicitly grant access to their pages or databases via SKUBIQ’s UI.
Workspace members explicitly grant access to their pages or databases via SKUBIQ’s UI.
OAuth Protocol
Not applicable, as access is limited to a single workspace.
Uses the OAuth 2.0 protocol to securely access information across multiple workspaces.
Dashboard Visibility
Visible to Workspace Owners in the integration dashboard, including integrations created by others.

Internal vs. Public Integrations

SKUBIQ’s REST API opens up a world of possibilities for integrations, ranging from enhancing internal workflow to creating public-facing applications. Here’s a closer look at some of the innovative integrations developers have built with SKUBIQ:

  • Data Integrations
  • Automated Notifications
  • Github Synchronization
  • External Data Import

Examples:

  • Create an integration
  • Working with comments
  • Working with databases
  • Working with files and media
  • Working with page content

Authorization

This guide describes the authorization flows for internal and public Notion integrations.

What is authorization?

Authorization is the process of granting an integration access to a user’s Notion data…

Internal integration auth flow set-up

To use an internal integration, start by creating your integration in the integration’s settings page…

				
					HTTP
GET /v1/pages/b55c9c91-384d-452b-81db-d1ef79372b75 HTTP/1.1
Authorization: Bearer {INTEGRATION_TOKEN}

JavaScript
const { Client } = require("@notionhq/client")
// Initializing a client
const notion = new Client({
auth: process.env.NOTION_TOKEN,
})
				
			
Public integration authorization overview
Once your integration has been made public, you can update your integration code to use the public auth flow.

As an overview, the authorization flow includes the following steps. Each step will be described in more detail below.

Navigate the user to the integration’s authorization URL. This URL is provided in the integration’s settings page. After the user selects which workspace pages to share, Notion redirects the user to the integration’s redirect URI and includes a code query parameter. The redirect URI is the one you specified in your integration’s settings page. You will make a POST request to create an access token , which will exchange the temporary code for an access token. The Notion API responds with an access token and some additional information. You will store the access token for future API requests. View the API reference docs to learn about available endpoints.

				
					Public integration auth flow set-up

When an integration is made public, any Notion user in any workspace can use it...

Copy  HTML
<a href="https://api.notion.com/v1/oauth/authorize?owner=user&#038;client_id=463558a3-725e-4f37-b6d3-0889894f68de&#038;redirect_uri=https%3A%2F%2Fexample.com%2Fauth%2Fnotion%2Fcallback&#038;response_type=code">Add to Notion</a>
				
			

Sale_Order API

Base URL

You can save the sale order using the API at the following base URL:

				
					http://localhost:35225/APIIntegrations/SaveSaleOrder
				
			
Authorization Header

You can build the Authorization header as follows:

				
					Authorization: skubiq-key <your_access_key>
				
			
Request Body

The body of this request has the following attributes:

SO Number
SO Quantity
Tenant Code
Mcode
So Date
Email
BUOM
Account Code
Customer Name
Status Name
Unit Price
string
integer
string
string
date
string
string
string
string
string
decimal
Save_SaleOrder JSON

SKUBIQ exposes a REST API. Send a well-formed JSON POST request containing Method and Params parameters.

				
					 {
                        "auth": {
                            "loggedInUserID": "string",
                            "transactionUserID": "string",
                            "authToken": "string"
                        },
                        "EntityObject": {
                                "TenantCode": "SUZ",
                                "AccountCode": "220916105858825",
                                "SONumber": "FFFFFFFFFF",
                                "CustomerName": "SUZ",
                                "SODate": "2023-01-02T00:00:00Z",
                                "Email": "test@456.com",
                                "SODetails": [
                                    {
                                        "SONumber": "TTTTTT",
                                        "LineNumber": 1,
                                        "BUoM": "Piece",
                                        "MCode": "GLASS",
                                        "UnitPrice": 9.99,  
                                        "SOQuantity": 100
                                    }
                                ]
                        },
                        "messages": [
                            {
                                "merlinWMSMessage": "string",
                                "merlinWMSExceptionCode": "string",
                                "uniqueErrorCode": "string",
                                "userMessage": true
                            }
                        ],
                        "isError": true
                        }
                    
				
			

Purchase_Order API

Base URL

You can save the purchase order using the API at the following base URL:

				
					http://localhost:35225/APIIntegrations/SavePurchaseOrder
				
			
Authorization Header

You can build the Authorization header as follows:

				
					Authorization: skubiq-key <your_access_key>
				
			
Request Body

The body of this request has the following attributes:

PO Number
PO Quantity
Tenant Code
M Code
PO Date
Email
BUOM
Account Code
Customer Name
Status Name
Unit Price
string
integer
string
string
date
string
string
string
string
string
decimal
Save_PurchaseOrder JSON

SKUBIQ exposes a REST API. Send a well-formed JSON POST request containing Method and Params parameters.

				
					
                            {
                                "auth": {
                                "loggedInUserID": "string",
                                "transactionUserID": "string",
                                "authToken": "string"
                            },
                            "EntityObject": {
                                    "Tenant": "SUZ",
                                    "AccountCode": "220916105858825",
                                    "PONumber": "TTTTTT%",
                                    "SupplierCode": "SUZ",
                                    "PODate": "2023-01-02T00:00:00Z",
                                    "Email": "test@456.com",
                                    "ExpDate":"1900-01-01 00:00:00+05:21:10",
                                    "MfgDate":"1900-01-01 00:00:00+05:21:10",
                                        "PODetails": [
                                        {
                                            "PONumber": "TTTTTT%",
                                            "LineNumber": 1,
                                            "BUoM": "Piece",
                                            "SKU": "GLASS",
                                            "UnitPrice": 9.99,
                                            "POQuantity": 1
                                        },
                                        {
                                            "PONumber": "TTTTTT%",
                                            "LineNumber": 2,
                                            "BUoM": "Piece",
                                            "SKU": "GLASS",
                                            "UnitPrice": 9.99,
                                            "POQuantity": 1
                                        }
                                        ]
                                },
                            "messages": [
                            {
                                "merlinWMSMessage": "string",
                                "merlinWMSExceptionCode": "string",
                                "uniqueErrorCode": "string",
                                "userMessage": true
                            }
                            ],
                            "isError": true
                            }
                        
				
			

Item_master Import API

Base URL

You can save the item master using the API at the following base URL:

				
					http://localhost:35225/APIIntegrations/ItemMasterImportExcel
				
			
Authorization Header

You can build the Authorization header as follows:

				
					Authorization: skubiq-key <your_access_key>
				
			
Request Body

The body of this request has the following attributes:

Part Number
OEM PartNo
Material Type
Product Category
Storage Condition
Item Description Short
Item Description Long
BUoM
BUoM Quantity
MUoM
MUoM Quantity
Tenant Code
Group Code
Account Code
string
string
string
string
string
string
string
string
integer
string
integer
string
string
string
Item_Master JSON

SKUBIQ exposes a REST API. Send a well-formed JSON POST request containing Method and Params parameters.

				
					 {
                                "auth": {
                                    "loggedInUserID": "string",
                                    "transactionUserID": "string",
                                    "authToken": "string"
                                },
                                "EntityObject": {
                                    "PartNumber": "TESTECOM6",
                                    "OEMPartNo": "",
                                    "MaterialType": "GEN",
                                    "ProductCategory": "",
                                    "StorageCondition": "DRY",
                                    "ItemDescriptionShort": "Test",
                                    "ItemDescriptionLong": "",
                                    "BUoM": "EA",
                                    "BUoM_Quantity": "1",
                                    "MUoM": "EA",
                                    "MUoM_Quantity": "1",
                                    "SupplierCode": "",
                                    "TenantCode": "App",
                                    "ishurequired": "No",
                                    "MLength": 0,
                                    "MWidth": 0,
                                    "MHeight": 0,
                                    "MWeight": 0,
                                    "GroupCode": "Genral",
                                    "CapacityPerBin": "0",
                                    "TenantName": "0",
                                    "SupplierName": "0",
                                    "MCodeAlternative1": "0",
                                    "MCodeAlternative2": "0",
                                    "IsActive": 1,
                                    "IsDeleted": 0,
                                    "UserID": 1164,
                                    "AccountID": 1139,
                                    "LoginAccountId":1139,
                                    "LoginUserId":1164,
                                    "LoginTenantId":0,
                                    "TenantId":0
                                    },
                                "messages": [
                                {
                                    "merlinWMSMessage": "string",
                                    "merlinWMSExceptionCode": "string",
                                    "uniqueErrorCode": "string",
                                    "userMessage": true
                                }
                                ],
                                "isError": true
                                }
				
			

Purchase_Order API

Base URL

You can save the purchase order using the API at the following base URL:

				
					http://localhost:35225/APIIntegrations/SavePurchaseOrder
				
			
Authorization Header

You can build the Authorization header as follows:

				
					Authorization: skubiq-key <your_access_key>
				
			
Request Body

The body of this request has the following attributes:

PO Number
PO Quantity
Tenant Code
M Code
PO Date
Email
BUOM
Account Code
Customer Name
Status Name
Unit Price
string
integer
string
string
date
string
string
string
string
string
decimal
Save_PurchaseOrder JSON

SKUBIQ exposes a REST API. Send a well-formed JSON POST request containing Method and Params parameters.

				
					{
                                "auth": {
                                "loggedInUserID": "string",
                                "transactionUserID": "string",
                                "authToken": "string"
                            },
                            "EntityObject": {
                                    "Tenant": "SUZ",
                                    "AccountCode": "220916105858825",
                                    "PONumber": "TTTTTT%",
                                    "SupplierCode": "SUZ",
                                    "PODate": "2023-01-02T00:00:00Z",
                                    "Email": "test@456.com",
                                    "ExpDate":"1900-01-01 00:00:00+05:21:10",
                                    "MfgDate":"1900-01-01 00:00:00+05:21:10",
                                        "PODetails": [
                                        {
                                            "PONumber": "TTTTTT%",
                                            "LineNumber": 1,
                                            "BUoM": "Piece",
                                            "SKU": "GLASS",
                                            "UnitPrice": 9.99,
                                            "POQuantity": 1
                                        },
                                        {
                                            "PONumber": "TTTTTT%",
                                            "LineNumber": 2,
                                            "BUoM": "Piece",
                                            "SKU": "GLASS",
                                            "UnitPrice": 9.99,
                                            "POQuantity": 1
                                        }
                                        ]
                                },
                            "messages": [
                            {
                                "merlinWMSMessage": "string",
                                "merlinWMSExceptionCode": "string",
                                "uniqueErrorCode": "string",
                                "userMessage": true
                            }
                            ],
                            "isError": true
                            }
				
			

ININ

This demo will let you access SKUBIQ products, its functionality, features and usability to assess and help your decision making of choosing the product.

Get A Quote

Get A Quote

Start building today with our 14 day trial. No commitment. No credit card required.

3PL

The SKUBIQ is a cloud based Warehouse management system and is designed for third-party logistics companies to manage multiple customers, processes and billing schedules. The system enables access to real-time information and provides integrations with warehouse management technologies, including EDI, barcode scanning, and e-commerce shopping carts. The software scalability helps companies to manage different stock levels in warehouses, streamline business, and satisfy customers.

SKUBIQ is designed to help logistics companies automate processes and bill items accurately. The software provides features which allow the user to easily add and remove customers and products. The software is designed to help logistics providers satisfy customers’ need for updated information and increase profits through process automation.

The SKUBIQ can be integrated with any line of business application or ERP thereby allowing users to synchronize items, inventory, purchase orders, and receipts.

Manufacturing

The manufacturing is a highly regulated industry globally where attention to detail is critical to help ensure stringent requirements for product quality and deadlines are met. Its become imperative for organizations to achieve a lean environment in which they have visibility to and control over these details is where competitive advantage often resides. SKUBIQ partners with major manufacturing companies globally to improve efficiency and reduce costs, such as:

  1. Support of lean manufacturing initiatives by including inventory management capabilities within manufacturing
  2. Initiating supplier re-orders based on demand signals
  3. Compliance with industry requirements for quality, product tracking, safety, and recall management
  4. Integrated RFID, including asset tracking
  5. Quality assurance and inspection
  6. Managing a large product catalog / SKU proliferation
  7. Addressing Customer OEM parts packaging
  8. Core stratification and remanufacturing
  9. Wave planning and small order pick optimization to reduce picker travel
  10. Serialized inventory tracking
  11. EDI / ASN integration

Distribution Center

Distributors normally lack precise and seamless traceability, lot control, and recall management capabilities jeopardizing the inventory thereby putting their businesses at risk of compliance failures and legal liabilities. In addition, they are constantly challenged by the emerging consumer demands for omni-channel commerce, specialized products, and more convenient delivery options

SKUBIQ is trusted worldwide for supply chain management and visibility. But Why? Simply because our uniquely adaptable software solutions help companies like you stay on top of this fast-changing market.

SKUBIQ helps address the complete process of fulfilling complex, multi-temperature home delivery orders. SKUBIQ has the inbuilt flexibility in helping emerging online retailers and distributors a wide range of specialty products through traditional eCommerce fulfillment models.

As one of the market leaders in warehouse management (WMS) for cold-storage, third-party-logistics companies that play a critical role distribution, we bridge inventory and distribution between some of the world’s largest producers and their customers.

Fashion and Retail

The SKUBIQ is a cloud based Warehouse management system and is designed for third-party logistics companies to manage multiple customers, processes and billing schedules. The system enables access to real-time information and provides integrations with warehouse management technologies, including EDI, barcode scanning, and e-commerce shopping carts. The software scalability helps companies to manage different stock levels in warehouses, streamline business, and satisfy customers.

SKUBIQ is designed to help logistics companies automate processes and bill items accurately. The software provides features which allow the user to easily add and remove customers and products. The software is designed to help logistics providers satisfy customers’ need for updated information and increase profits through process automation.

The SKUBIQ can be integrated with any line of business application or ERP thereby allowing users to synchronize items, inventory, purchase orders, and receipts.

Fast-moving Consumer Goods

The manufacturing is a highly regulated industry globally where attention to detail is critical to help ensure stringent requirements for product quality and deadlines are met. Its become imperative for organizations to achieve a lean environment in which they have visibility to and control over these details is where competitive advantage often resides. SKUBIQ partners with major manufacturing companies globally to improve efficiency and reduce costs, such as:

  1. Support of lean manufacturing initiatives by including inventory management capabilities within manufacturing
  2. Initiating supplier re-orders based on demand signals
  3. Compliance with industry requirements for quality, product tracking, safety, and recall management
  4. Integrated RFID, including asset tracking
  5. Quality assurance and inspection
  6. Managing a large product catalog / SKU proliferation
  7. Addressing Customer OEM parts packaging
  8. Core stratification and remanufacturing
  9. Wave planning and small order pick optimization to reduce picker travel
  10. Serialized inventory tracking
  11. EDI / ASN integration

Automobile

Distributors normally lack precise and seamless traceability, lot control, and recall management capabilities jeopardizing the inventory thereby putting their businesses at risk of compliance failures and legal liabilities. In addition, they are constantly challenged by the emerging consumer demands for omni-channel commerce, specialized products, and more convenient delivery options

SKUBIQ is trusted worldwide for supply chain management and visibility. But Why? Simply because our uniquely adaptable software solutions help companies like you stay on top of this fast-changing market.

SKUBIQ helps address the complete process of fulfilling complex, multi-temperature home delivery orders. SKUBIQ has the inbuilt flexibility in helping emerging online retailers and distributors a wide range of specialty products through traditional eCommerce fulfillment models.

As one of the market leaders in warehouse management (WMS) for cold-storage, third-party-logistics companies that play a critical role distribution, we bridge inventory and distribution between some of the world’s largest producers and their customers.

Pharma & Surgical

The SKUBIQ WMS Software is a cloud-based Warehouse management system and is designed for third-party logistics companies to manage multiple customers, processes and billing schedules. The system enables access to real-time information and provides integrations with warehouse management technologies, including EDI, barcode scanning, and e-commerce shopping carts. The software scalability helps companies to manage different stock levels in warehouses, streamline business, and satisfy customers.

SKUBIQ WMS Software is designed to help logistics companies automate processes and bill items accurately. The software provides features which allow the user to easily add and remove customers and products. The software is designed to help logistics providers satisfy customers’ need for updated information and increase profits through process automation.

The SKUBIQ can be integrated with any line of business application or ERP thereby allowing users to synchronize items, inventory, purchase orders, and receipts.