Zentail API (v1)

Welcome to the Zentail API

This is an outline of all the currently supported Zentail API actions.

Please review or have your developers review this document and submit any feedback you may have. We’re always open to working together on new endpoints and functionality. Please let us know if you have any feedback.

Server

URL
https://api.zentail.com/v1

Authentication

zentail_auth

Security Scheme Type API Key
Header parameter name: AUTHORIZATION

Inventory

Retrieve detailed inventory data for a SKU

Returns available quantity for the SKU in all warehouses, and inbound inventory data.

Path Parameters

NameDescription
SKU
string*

Responses

StatusDescription
200 successSuccess
Show common responses
Response Schema
NameDescription
SKU
string*
active
boolean*
standardProductId
string*

Depending on the type defined in standardProductIdType this field contains either the UPC, EAN, ISBN, or GTIN for this product.

standardProductIdType
string*

One of UPC, EAN, ISBN or GTIN.

Show More
cURL
Send
curl --request GET \ --url https://api.zentail.com/v1/inventory/%7BSKU%7D \ --header 'AUTHORIZATION: REPLACE_KEY_VALUE' \ --header 'content-type: application/json'
Response
{
  • "SKU": "string",
  • "active": true,
  • "standardProductId": "string",
  • "standardProductIdType": "string",
  • "totalAvailableQuantity": 0,
  • "warehouses": [
    ],
  • "lastInventoryUpdateTs": "2019-08-24T14:15:22Z"
}
Was this section helpful?
Yes No

Retrieve detailed inventory data

Retrieve inventory data for SKUs with various filters. One of lastUpdatedTs, skus, warehouses is required to be passed in as a parameters.

Query Parameters

NameDescription
activeOnly
boolean
lastUpdatedTs
string

Providing lastUpdateTs returns inventory for all SKUs updated after that timestamp.

skus
array

If a list of SKUs is provided, lastUpdatedTs and warehouses are ignored.

isCaseSensitive
boolean

If this is true, a case-sensitive match will be used to search for the 'skus' provided. If false, as case-insensitive search will be used. Default value is true.

Default: true
Show More

Responses

StatusDescription
200 successSuccess
Show common responses
Response Schema
NameDescription
results
array*
errors
array*
pagination
object*
cURL
Send
curl --request GET \ --url 'https://api.zentail.com/v1/inventory' \ --header 'AUTHORIZATION: REPLACE_KEY_VALUE' \ --header 'content-type: application/json'
Response
{
  • "results": [
    ],
  • "errors": [
    ],
  • "pagination": {}
}
Was this section helpful?
Yes No

Modify, Update inventory data

This call allows updating inventory data for SKUs. If the SKU does not exist in your Zentail account, it will be created and assigned the inventory provided. This works only for warhouses that dont have an integration controlling inventory.


Request body schema

Provide the validAsOf timestamp and the items (Up to 50 SKUs per call)

NameDescription
products
array*
validAsOf
string

Responses

StatusDescription
200 successSuccess
Show common responses
Response Schema
Array of
NameDescription
SKU
string*

SKU value is the unique identifier for a product in Zentail.

standardProductId
string*

Depending on the type defined in standardProductIdType this field contains either the UPC, EAN, ISBN, or GTIN for this product.

standardProductIdType
string*

One of UPC, EAN, ISBN or GTIN.

active
boolean*
Show More
cURL
Send
curl --request POST \ --url https://api.zentail.com/v1/inventory \ --header 'AUTHORIZATION: REPLACE_KEY_VALUE' \ --header 'content-type: application/json' \ --data '{"products":[{"SKU":"string","quantity":0,"delta_quantity":0,"onhand_quantity":0,"binLocation":"string","warehouseId":0,"warehouseUniqueId":"string"}],"validAsOf":"2019-08-24T14:15:22Z"}'
Response
[
  • {
    }
]
Was this section helpful?
Yes No

SalesOrder

Retrieve detailed Sales Order information for a list of orders

Returns very detailed information about a sales order including accounting data, tracking/package data, line items for all sales orders that match the search criteria provided. Results are sorted by the lastUpdateTs from oldest to newest.

Query Parameters

NameDescription
lastUpdatedTs
string

If provided, only orders with a last updated timestamp greater than or equal to the one provided (inclusive) will be included.

status
array

If provided, only orders with the given status will be included.

Possible Values: PENDING_PAYMENT, PENDING, PARTIALLY_SHIPPED, SHIPPED, CANCELLED, RETURNED, REFUNDED OR RETURN_REQUESTED
channelOrderIds
array

If provided, only orders with the given Channel Order Ids will be included.

orderTs
string

If provided, only orders with a timestamp greater than or equal to the one provided (inclusive) will be included.

Show More

Responses

StatusDescription
200 successSuccess
Show common responses
Response Schema
NameDescription
results
array*

An array of SalesOrder results

pagination
object*
cURL
Send
curl --request GET \ --url 'https://api.zentail.com/v1/salesOrder' \ --header 'AUTHORIZATION: REPLACE_KEY_VALUE' \ --header 'content-type: application/json'
Response
{
  • "results": [
    ],
  • "pagination": {}
}
Was this section helpful?
Yes No

Get detailed Sales Order information

Returns very detailed information about a sales order including accounting data, tracking/package data, line items for the sales order with the given Zentail Order Number

Path Parameters

NameDescription
orderNumber
number*

Zentail Order Number

Responses

StatusDescription
200 successSuccess
Show common responses
Response Schema
NameDescription
orderNumber
string*

The unique identifier for an order in Zentail

status
string*
Default: PENDING
Possible Values: PENDING_PAYMENT, PENDING, PARTIALLY_SHIPPED, SHIPPED, CANCELLED, RETURNED, REFUNDED OR RETURN_REQUESTED
cancellationReason
string*

If the order is CANCELLED this will provide the reason for the cancellation.

channel
string*

The name of the sales channel where the order was placed.

Show More
cURL
Send
curl --request GET \ --url https://api.zentail.com/v1/salesOrder/%7BorderNumber%7D \ --header 'AUTHORIZATION: REPLACE_KEY_VALUE' \ --header 'content-type: application/json'
Response
{
  • "orderNumber": "string",
  • "status": "PENDING",
  • "cancellationReason": "string",
  • "channel": "string",
  • "channelLabel": "string",
  • "channelOrderId": "string",
  • "channelOrderReferenceNumber": "string",
  • "customer_notes": "string",
  • "marketplaceId": "string",
  • "customerName": "string",
  • "customerEmail": "string",
  • "orderTs": "2019-08-24T14:15:22Z",
  • "lastUpdatedTs": "2019-08-24T14:15:22Z",
  • "requestedServiceLevel": "string",
  • "standardServiceLevel": "Standard",
  • "shipBy": "2019-08-24T14:15:22Z",
  • "accounting": {
    },
  • "shippingAddress": {
    },
  • "billingAddress": {
    },
  • "packages": [
    ],
  • "products": [
    ],
  • "returnOrders": [
    ],
  • "fba": true,
  • "prime": true,
  • "businessOrder": true
}
Was this section helpful?
Yes No

Warehouse

Retrieve a list of all Warehouses

Returns a list of all Warehouses associated with this account. Warehouse IDs should be used when updating inventory using the API.


Responses

StatusDescription
200 successSuccess
Show common responses
Response Schema
NameDescription
results
array*
cURL
Send
curl --request GET \ --url https://api.zentail.com/v1/warehouses \ --header 'AUTHORIZATION: REPLACE_KEY_VALUE' \ --header 'content-type: application/json'
Response
{
  • "results": [
    ]
}
Was this section helpful?
Yes No

Warehouse name and address information

Returns the ID, name, and address of the warehouse requested.

Path Parameters

NameDescription
id
number*

Warehouse ID

Responses

StatusDescription
200 successSuccess
Show common responses
Response Schema
NameDescription
warehouse_id
number*

A unique identifier for this warehouse, should be used when updating inventory through the API.

warehouseUniqueId
string*

Unique identifier for the warehouse as recognized by the application.

name
string*
address
object*
cURL
Send
curl --request GET \ --url https://api.zentail.com/v1/warehouse/%7Bid%7D \ --header 'AUTHORIZATION: REPLACE_KEY_VALUE' \ --header 'content-type: application/json'
Was this section helpful?
Yes No