Manage DecoNetwork inventory across catalog and custom products. Search SKU-based inventory with search conditions and pagination, and update inventory levels and related settings for SKUs. Responses carry a standardized response_status object with severity and status codes.
openapi: 3.0.3
info:
title: DecoNetwork JSON API
version: '1.0'
description: >-
Public JSON API for DecoNetwork, the web-to-print and business-management
platform for custom apparel decorators and print shops. The API lets
Enterprise-plan sites search and update orders, manage products, manage
inventory, and manage purchase orders, for integration with external carts,
ERP/CRM systems, and production automation.
Endpoints and paths in this document are transcribed from DecoNetwork's
published developer reference at developer.deconetwork.com. Requests are
authenticated with account username and password fields passed either as
query parameters (GET/POST) or in the application/x-www-form-urlencoded
body. Requests are form-encoded (some POST bodies are JSON) and all
responses are JSON carrying a response_status object with a code, severity
(SUCCESS or ERROR), and description. API access is included on the
Enterprise plan only.
contact:
name: DecoNetwork Developer Resources
url: https://www.deconetwork.com/developer-resources/
servers:
- url: https://www.deconetwork.com
description: >-
DecoNetwork API host. In practice each merchant operates on their own
DecoNetwork site domain; substitute your site host as documented.
security:
- credentials: []
paths:
/api/json/manage_orders/find:
get:
operationId: findOrders
summary: Search orders
description: >-
Search orders with multi-condition filtering (logical AND), sorting, and
pagination. Returns up to 100 results per request. Workflow, purchase
order, shipment, and production file data can optionally be included.
tags:
- Orders
parameters:
- name: username
in: query
required: true
schema:
type: string
- name: password
in: query
required: true
schema:
type: string
responses:
'200':
description: JSON list of matching orders with a response_status object.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResponse'
/api/json/manage_orders/update_order_status:
post:
operationId: updateOrderStatus
summary: Update order status
description: >-
Update order or line-item status to Produced or Shipped. Supports batch
updates using the indexed parameter format changes[n][parameter_name].
tags:
- Orders
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
type: object
required:
- username
- password
properties:
username:
type: string
password:
type: string
responses:
'200':
description: JSON result with a response_status object.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResponse'
/api/json/manage_products/find:
post:
operationId: findProducts
summary: Search products
description: >-
Search products based on multiple conditions joined with logical AND.
Returns up to 100 results per request with offset pagination and
ISO-8601 UTC date filtering.
tags:
- Products
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
type: object
required:
- username
- password
properties:
username:
type: string
password:
type: string
responses:
'200':
description: JSON list of matching products with a response_status object.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResponse'
/api/json/manage_products/get:
get:
operationId: getProducts
summary: Get products by ID
description: Retrieve a single product or multiple products by ID.
tags:
- Products
parameters:
- name: username
in: query
required: true
schema:
type: string
- name: password
in: query
required: true
schema:
type: string
responses:
'200':
description: JSON product(s) with a response_status object.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResponse'
/api/json/manage_inventory/find:
get:
operationId: findInventory
summary: Search inventory
description: >-
Search SKU-based inventory across catalog and custom products using
search conditions, with pagination. Returns up to 100 rows per request.
tags:
- Inventory
parameters:
- name: username
in: query
required: true
schema:
type: string
- name: password
in: query
required: true
schema:
type: string
responses:
'200':
description: JSON inventory list with a response_status object.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResponse'
/api/json/manage_inventory/update:
post:
operationId: updateInventory
summary: Update inventory
description: Update inventory levels and related settings for SKUs.
tags:
- Inventory
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
type: object
required:
- username
- password
properties:
username:
type: string
password:
type: string
responses:
'200':
description: JSON result with a response_status object.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResponse'
/api/json/manage_purchase_orders/find:
get:
operationId: findPurchaseOrders
summary: Search purchase orders
description: >-
Retrieve a list of purchase orders based on search parameters. Returns
up to 100 rows per request.
tags:
- Purchase Orders
parameters:
- name: username
in: query
required: true
schema:
type: string
- name: password
in: query
required: true
schema:
type: string
responses:
'200':
description: JSON list of purchase orders with a response_status object.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResponse'
/api/json/manage_purchase_orders/receive_stock:
post:
operationId: receiveStock
summary: Receive stock
description: >-
Record stock receipt against purchase orders and customer orders.
tags:
- Purchase Orders
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- username
- password
properties:
username:
type: string
password:
type: string
responses:
'200':
description: JSON result with a response_status object.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResponse'
components:
securitySchemes:
credentials:
type: apiKey
in: query
name: username
description: >-
DecoNetwork authenticates each request with username and password
fields passed as query parameters (GET/POST) or in the form-encoded
body. Both fields are required on every request.
schemas:
ApiResponse:
type: object
description: Standard DecoNetwork JSON envelope.
properties:
response_status:
$ref: '#/components/schemas/ResponseStatus'
ResponseStatus:
type: object
properties:
code:
type: integer
description: Status code (10001 indicates SUCCESS; 30001+ indicate ERROR/WARNING).
severity:
type: string
enum:
- SUCCESS
- ERROR
description:
type: string
description: Human-readable detail, present on errors.