Pipe17 logo
API docs by Redocly

Pipe17 API (3.0.370)

Download OpenAPI specification:Download

E-mail: support@pipe17.com License: Pipe17 License Terms of Service

Generic interface to Pipe17 services

About Pipe17

Arrivals

Operations about Arrival Notifications

Arrival Model

senderName
required
string

Sender's Name

toLocationId
required
string

Arrival Location ID

arrivalId
string

Arrival notification ID

createdAt
string <date-time>

When the object was created within Pipe17

Array of objects (NameValue)

Custom Fields

exceptions
Array of strings

References to exceptions related to the arrival

expectedArrivalDate
string <date-time>

Expected Arrival Date

extArrivalId
string

Reference to arrival on external system (vendor)

extOrderId
string

External TO or PO ID

extShipmentId
string

External shipment ID

object (Address)
fromLocationId
string

Sender Location ID (for TO)

fulfillmentId
string

Fulfillment ID

holdUntil
string <date-time>
incoterms
string

International Commercial Terms

integration
string

Reference to integration that created an item

object (InternalInfo)

Internal info

Array of objects (ArrivalLineItem)
orgKey
string

Organization this object belong to

purchaseId
string

Purchase Order ID

shippingCarrier
string

Shipping Carrier

shippingMethod
string

Shipping Method

shippingNote
string

Shipping Note

object (SourceDoc)

Vendor source document

status
string
Enum: "draft" "shipped" "expected" "partialReceived" "received" "canceled" "failed"

Arrival notification Status

Array of ArrivalChangelogEntry (object) or FulfillmentChangelogEntry (object) or ReceiptChangelogEntry (object) or ShipmentChangelogEntry (object) (ChangelogEntry)

Timeline of updates

totalWeight
string

Total Weight

trackingNumber
string

Tracking number

transferId
string

Transfer Order ID

object (ArrivalTransport)
updatedAt
string <date-time>

When the object was updated within Pipe17

weightUnit
string

Weight Unit

{
  • "arrivalId": "string",
  • "exceptions": [
    ],
  • "integration": "string",
  • "status": "draft",
  • "timeline": [
    ],
  • "senderName": "string",
  • "toLocationId": "string",
  • "customFields": [
    ],
  • "expectedArrivalDate": "2019-08-24T14:15:22Z",
  • "extArrivalId": "string",
  • "extOrderId": "string",
  • "extShipmentId": "string",
  • "fromAddress": {
    },
  • "fromLocationId": "string",
  • "fulfillmentId": "string",
  • "holdUntil": "2019-08-24T14:15:22Z",
  • "incoterms": "string",
  • "internal": {
    },
  • "lineItems": [
    ],
  • "purchaseId": "string",
  • "shippingCarrier": "string",
  • "shippingMethod": "string",
  • "shippingNote": "string",
  • "sourceDoc": {
    },
  • "totalWeight": "string",
  • "trackingNumber": "string",
  • "transferId": "string",
  • "transport": {
    },
  • "weightUnit": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Arrival Notifications

Uniqueness constraints:

  • arrival.transferId, arrival.fulfillmentId (when defined both)
  • arrival.purchaseId, arrival.fulfillmentId (when defined both)
  • arrival.fulfillmentId (when defined)

Uniqueness constraints within organization:

  • arrival.extArrivalId (when defined)
Authorizations:
Pipe17KeyAuth
Request Body schema:
Array (<= 10 items)
senderName
required
string

Sender's Name

toLocationId
required
string

Arrival Location ID

Array of objects (NameValue)

Custom Fields

expectedArrivalDate
string <date-time>

Expected Arrival Date

extArrivalId
string

Reference to arrival on external system (vendor)

extOrderId
string

External TO or PO ID

extShipmentId
string

External shipment ID

object (Address)
fromLocationId
string

Sender Location ID (for TO)

fulfillmentId
string

Fulfillment ID

holdUntil
string <date-time>
incoterms
string

International Commercial Terms

object (InternalInfo)

Internal info

Array of objects (ArrivalLineItem)
purchaseId
string

Purchase Order ID

shippingCarrier
string

Shipping Carrier

shippingMethod
string

Shipping Method

shippingNote
string

Shipping Note

object (SourceDoc)

Vendor source document

status
string (ArrivalStatus)
Enum: "draft" "shipped" "expected" "partialReceived" "received" "canceled" "failed"

Arrival notification Status

totalWeight
string

Total Weight

trackingNumber
string

Tracking number

transferId
string

Transfer Order ID

object (ArrivalTransport)
weightUnit
string

Weight Unit

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "arrivals": [
    ]
}

Delete Arrival

Authorizations:
Pipe17KeyAuth
path Parameters
ArrivalId
required
string

Id or ext:{extArrivalId} of arrival to delete

query Parameters
nested
boolean

Delete nested entities

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Delete Multiple Arrivals

Authorizations:
Pipe17KeyAuth
query Parameters
action
string (ListDeleteAction)
Default: "list"
Enum: "list" "soft"

Return the list of what to delete, or delete softly

arrivalId
Array of strings

Delete arrivals by list of arrivalId

count
integer <int32>
Default: 100

Delete at most this many arrivals

deleted
boolean

Delete soft deleted arrivals

extOrderId
Array of strings

Delete arrivals by list external orders (PO or TO)

fulfillmentId
Array of strings

Delete arrivals by list fulfillmentId

integration
Array of strings

Delete arrivals of these integrations.

orgMode
Array of strings (OrganizationMode)
Items Enum: "sandbox" "production" "internal" "demo"

Delete arrivals assigned these orgModes.

pagination
string
Value: "disabled"

Exclude pagination info from the response

purchaseId
Array of strings

Delete arrivals by list purchase orders

since
string <date-time>

Delete arrivals created after this date-time

skip
integer <int32>
Default: 0

Skip this many arrivals

status
Array of strings (ArrivalStatus)
Items Enum: "draft" "shipped" "expected" "partialReceived" "received" "canceled" "failed"

Delete arrivals in specific status

transferId
Array of strings

Delete arrivals by list transfer orders

until
string <date-time>

Delete arrivals created before this date-time

updatedSince
string <date-time>

Delete arrivals updated after this date-time

updatedUntil
string <date-time>

Delete arrivals updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "arrivals": [
    ],
  • "deleted": 0,
  • "filters": {
    },
  • "pagination": {
    }
}

Fetch Arrival Notification

Authorizations:
Pipe17KeyAuth
path Parameters
ArrivalId
required
string

Id or ext:{extArrivalId} of arrival to fetch

query Parameters
sourceDocVersion
number

Fetch specific vendor source doc version if available

withSourceDoc
boolean

Include vendor source doc if available

withSourceDocVersions
boolean

Include available vendor source doc versions

withTimeline
boolean

Include timeline of updates when available

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "arrival": {
    }
}

List Arrival Notifications

Authorizations:
Pipe17KeyAuth
query Parameters
arrivalId
Array of strings

Arrivals by list of arrivalId

count
integer <int32>
Default: 100

Return at most this many arrivals

deleted
boolean

Soft deleted arrivals

exceptionCategoryId
Array of strings

Arrivals by list of categories of the arrival related exceptions

exceptionType
Array of strings

Arrivals by list of types of the arrival related exceptions ({exceptionType} | {entityType}_{exceptionType})

extArrivalId
Array of strings

Arrivals by list extArrivalId

extOrderId
Array of strings

Arrivals by list external orders (PO or TO)

fromLocationId
Array of strings

Arrivals by list fromLocationId

fulfillmentId
Array of strings

Arrivals by list fulfillmentId

hasSourceDoc
boolean

Arrivals containing a source document

keys
string
Default: "arrivalId,status,transferId,purchaseId,extOrderId,expectedArrivalDate,createdAt,updatedAt,orgKey"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

purchaseId
Array of strings

Arrivals by list purchase orders

since
string <date-time>

Arrivals created after this date-time

skip
integer <int32>
Default: 0

Skip this many arrivals

status
Array of strings (ArrivalStatus)
Items Enum: "draft" "shipped" "expected" "partialReceived" "received" "canceled" "failed"

Arrivals in specific status

toLocationId
Array of strings

Arrivals by list toLocationId

transferId
Array of strings

Arrivals by list transfer orders

until
string <date-time>

Arrivals created before this date-time

updatedSince
string <date-time>

Arrivals updated after this date-time

updatedUntil
string <date-time>

Arrivals updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "arrivals": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Sync Arrivals

Trigger the arrivals sync

Authorizations:
Pipe17KeyAuth
path Parameters
ArrivalId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Arrival Notification

Uniqueness constraints:

  • arrival.transferId, arrival.fulfillmentId (when defined both)
  • arrival.purchaseId, arrival.fulfillmentId (when defined both)
  • arrival.fulfillmentId (when defined)

Uniqueness constraints within organization:

  • arrival.extArrivalId (when defined)
Authorizations:
Pipe17KeyAuth
path Parameters
ArrivalId
required
string

Arrival Id to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
Array of objects (NameValue)

Custom Fields

expectedArrivalDate
string <date-time>

Expected Arrival Date

extArrivalId
string

Reference to arrival on external system (vendor)

object (Address)
fromLocationId
string

Sender Location ID (for TO)

holdUntil
string or null <date-time>
incoterms
string

International Commercial Terms

object (InternalInfo)

Internal info

Array of objects (ArrivalLineItem)
senderName
string

Sender's Name

shippingCarrier
string

Shipping Carrier

shippingMethod
string

Shipping Method

shippingNote
string

Shipping Note

object (SourceDoc)

Vendor source document

status
string (ArrivalStatus)
Enum: "draft" "shipped" "expected" "partialReceived" "received" "canceled" "failed"

Arrival notification Status

toLocationId
string

Arrival Location ID

totalWeight
string

Total Weight

trackingNumber
string

Tracking number

object (ArrivalTransport)
weightUnit
string

Weight Unit

Responses

Request samples

Content type
{
  • "customFields": [
    ],
  • "expectedArrivalDate": "2019-08-24T14:15:22Z",
  • "extArrivalId": "string",
  • "fromAddress": {
    },
  • "fromLocationId": "string",
  • "holdUntil": "2019-08-24T14:15:22Z",
  • "incoterms": "string",
  • "internal": {
    },
  • "lineItems": [
    ],
  • "senderName": "string",
  • "shippingCarrier": "string",
  • "shippingMethod": "string",
  • "shippingNote": "string",
  • "sourceDoc": {
    },
  • "status": "draft",
  • "toLocationId": "string",
  • "totalWeight": "string",
  • "trackingNumber": "string",
  • "transport": {
    },
  • "weightUnit": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "arrival": {
    }
}

Catalog Products

Operations about Catalog Products

Catalog Product Model

catalogId
required
string
sku
required
string
status
required
string (CatalogProductStatus)
Enum: "included" "excluded"

Catalog Product Status

catalogProductId
string

Auto Generated

createdAt
string <date-time>

When the object was created within Pipe17

Array of objects (NameValue)

Custom Fields

exceptions
Array of strings

References to exceptions related to the catalog product

integration
string

Reference to integration that created the catalog product

object (InternalInfo)

Internal info

orgKey
string

Organization this object belong to

object (CatalogProductPriceRule)
object (CatalogProductQuantityRule)
object (SourceDoc)

Vendor source document

tags
Array of strings (EntityTags)

Tags assigned to entity

updatedAt
string <date-time>

When the object was updated within Pipe17

Array of objects (CatalogProductVolumePricing)
{
  • "catalogProductId": "string",
  • "exceptions": [
    ],
  • "integration": "string",
  • "catalogId": "string",
  • "sku": "string",
  • "status": "included",
  • "customFields": [
    ],
  • "internal": {
    },
  • "priceRule": {
    },
  • "quantityRule": {
    },
  • "sourceDoc": {
    },
  • "tags": [
    ],
  • "volumePricing": [
    ],
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Catalog Products

Uniqueness constraints within organization:

  • catalogProduct.catalogId, catalogProduct.sku
Authorizations:
Pipe17KeyAuth
Request Body schema:
Array (<= 10 items)
catalogId
required
string
sku
required
string
status
required
string (CatalogProductStatus)
Enum: "included" "excluded"

Catalog Product Status

Array of objects (NameValue)

Custom Fields

object (InternalInfo)

Internal info

object (CatalogProductPriceRule)
object (CatalogProductQuantityRule)
object (SourceDoc)

Vendor source document

tags
Array of strings (EntityTags)

Tags assigned to entity

Array of objects (CatalogProductVolumePricing)

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "catalog_products": [
    ]
}

Delete Catalog Product

Authorizations:
Pipe17KeyAuth
path Parameters
CatalogProductId
required
string

Catalog Product Id to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Catalog Product

Authorizations:
Pipe17KeyAuth
path Parameters
CatalogProductId
required
string

Catalog Product Id to fetch

query Parameters
sourceDocVersion
number

Fetch specific vendor source doc version if available

withSourceDoc
boolean

Include vendor source doc if available

withSourceDocVersions
boolean

Include available vendor source doc versions

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "catalog_product": {
    }
}

List Catalog Products

Authorizations:
Pipe17KeyAuth
query Parameters
catalogId
Array of strings

Select catalog products by catalogId list

catalogProductId
Array of strings

Select catalog products by catalogProductId list

count
integer <int32>
Default: 100

Return at most this many catalog products

deleted
boolean

Select the soft deleted catalog products

exceptionCategoryId
Array of strings

Select catalog products by list of categories of the product related exceptions

exceptionType
Array of strings

Select catalog products by list of types of the product related exceptions ({exceptionType} | {entityType}_{exceptionType})

hasSourceDoc
boolean

Select catalog products containing a source document

keys
string
Default: "catalogProductId,catalogId,sku,status,priceRule,quantityRule,volumePricing,createdAt,updatedAt,orgKey"

Return these top-level fields

order
string
Default: "-createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Select catalog products created after this date-time

skip
integer <int32>
Default: 0

Skip this many catalog products

sku
Array of strings

Select catalog products by sku list

status
Array of strings (CatalogProductStatus)
Items Enum: "included" "excluded"

Select catalog products by status list

tags
Array of strings (EntityTags)

Tags assigned to entity

until
string <date-time>

Select catalog products created before this date-time

updatedSince
string <date-time>

Select catalog products updated after this date-time

updatedUntil
string <date-time>

Select catalog products updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "catalog_products": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Update Catalog Product

Authorizations:
Pipe17KeyAuth
path Parameters
CatalogProductId
required
string

Catalog Id to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
catalogId
string
Array of objects (NameValue)

Custom Fields

object (InternalInfo)

Internal info

object (CatalogProductPriceRule)
object (CatalogProductQuantityRule)
sku
string
object (SourceDoc)

Vendor source document

status
string (CatalogProductStatus)
Enum: "included" "excluded"

Catalog Product Status

tags
Array of strings (EntityTags)

Tags assigned to entity

Array of objects (CatalogProductVolumePricing)

Responses

Request samples

Content type
{
  • "catalogId": "string",
  • "customFields": [
    ],
  • "internal": {
    },
  • "priceRule": {
    },
  • "quantityRule": {
    },
  • "sku": "string",
  • "sourceDoc": {
    },
  • "status": "included",
  • "tags": [
    ],
  • "volumePricing": [
    ]
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "catalog_product": {
    }
}

Catalogs

Operations about Catalogs

Catalog Model

currency
required
string

Currency code

name
required
string
catalogId
string

Auto Generated

createdAt
string <date-time>

When the object was created within Pipe17

Array of objects (NameValue)

Custom Fields

description
string
exceptions
Array of strings

References to exceptions related to the catalog

extCatalogId
string
includeAll
boolean
integration
string

Reference to integration that created the catalog

object (InternalInfo)

Internal info

orgKey
string

Organization this object belong to

object (CatalogPriceRule)
object (SourceDoc)

Vendor source document

status
string (CatalogStatus)
Default: "draft"
Enum: "draft" "active" "inactive"

Catalog Status

tags
Array of strings (EntityTags)

Tags assigned to entity

type
string (CatalogType)
Default: "other"
Enum: "b2b" "market" "collection" "other"

Catalog Type

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "catalogId": "string",
  • "exceptions": [
    ],
  • "integration": "string",
  • "currency": "string",
  • "name": "string",
  • "customFields": [
    ],
  • "description": "string",
  • "extCatalogId": "string",
  • "includeAll": true,
  • "internal": {
    },
  • "priceRule": {
    },
  • "sourceDoc": {
    },
  • "status": "draft",
  • "tags": [
    ],
  • "type": "b2b",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Catalogs

Uniqueness constraints within organization:

  • catalog.extCatalogId, if the extCatalogId is defined
Authorizations:
Pipe17KeyAuth
Request Body schema:
Array (<= 10 items)
currency
required
string

Currency code

name
required
string
Array of objects (NameValue)

Custom Fields

description
string
extCatalogId
string
includeAll
boolean
object (InternalInfo)

Internal info

object (CatalogPriceRule)
object (SourceDoc)

Vendor source document

status
string (CatalogStatus)
Default: "draft"
Enum: "draft" "active" "inactive"

Catalog Status

tags
Array of strings (EntityTags)

Tags assigned to entity

type
string (CatalogType)
Default: "other"
Enum: "b2b" "market" "collection" "other"

Catalog Type

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "catalogs": [
    ]
}

Delete Catalog

Authorizations:
Pipe17KeyAuth
path Parameters
CatalogId
required
string

Catalog Id to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Catalog

Authorizations:
Pipe17KeyAuth
path Parameters
CatalogId
required
string

Catalog Id to fetch

query Parameters
sourceDocVersion
number

Fetch specific vendor source doc version if available

withSourceDoc
boolean

Include vendor source doc if available

withSourceDocVersions
boolean

Include available vendor source doc versions

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "catalog": {
    }
}

List Catalogs

Authorizations:
Pipe17KeyAuth
query Parameters
catalogId
Array of strings

Select catalogs by catalogId list

count
integer <int32>
Default: 100

Return at most this many catalogs

deleted
boolean

Select the soft deleted catalogs

exceptionCategoryId
Array of strings

Select catalogs by list of categories of the catalog related exceptions

exceptionType
Array of strings

Select catalogs by list of types of the catalog related exceptions ({exceptionType} | {entityType}_{exceptionType})

extCatalogId
Array of strings

Select catalogs by extCatalogId list

hasSourceDoc
boolean

Select catalogs containing a source document

keys
string
Default: "catalogId,extCatalogId,name,status,type,currency,priceRule,includeAll,createdAt,updatedAt,orgKey"

Return these top-level fields

name
Array of strings

Select catalogs by name list

order
string
Default: "-createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Select catalogs created after this date-time

skip
integer <int32>
Default: 0

Skip this many catalogs

status
Array of strings (CatalogStatus)
Items Enum: "draft" "active" "inactive"

Select catalogs by status list

tags
Array of strings (EntityTags)

Tags assigned to entity

type
Array of strings (CatalogType)
Items Enum: "b2b" "market" "collection" "other"

Select catalogs by type list

until
string <date-time>

Select catalogs created before this date-time

updatedSince
string <date-time>

Select catalogs updated after this date-time

updatedUntil
string <date-time>

Select catalogs updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "catalogs": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Update Catalog

Authorizations:
Pipe17KeyAuth
path Parameters
CatalogId
required
string

Catalog Id to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
currency
string

Currency code

Array of objects (NameValue)

Custom Fields

description
string
extCatalogId
string
includeAll
boolean
object (InternalInfo)

Internal info

name
string
object (CatalogPriceRule)
object (SourceDoc)

Vendor source document

status
string (CatalogStatus)
Default: "draft"
Enum: "draft" "active" "inactive"

Catalog Status

tags
Array of strings (EntityTags)

Tags assigned to entity

type
string (CatalogType)
Default: "other"
Enum: "b2b" "market" "collection" "other"

Catalog Type

Responses

Request samples

Content type
{
  • "currency": "string",
  • "customFields": [
    ],
  • "description": "string",
  • "extCatalogId": "string",
  • "includeAll": true,
  • "internal": {
    },
  • "name": "string",
  • "priceRule": {
    },
  • "sourceDoc": {
    },
  • "status": "draft",
  • "tags": [
    ],
  • "type": "b2b"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "catalog": {
    }
}

Contacts

Operations about contacts

Contact Model

required
object (Address)
contactId
string

Contact ID

createdAt
string <date-time>

When the object was created within Pipe17

Array of objects (ContactCustomField)
exceptions
Array of strings

References to exceptions related to the contact

extContactId
string

Contact external ID

object (InternalInfo)

Internal info

name
string

Contact name

orgKey
string

Organization this object belong to

status
string (ContactStatus)
Enum: "active" "deleted"

Contact status

tags
Array of strings (EntityTags)

Tags assigned to entity

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "contactId": "string",
  • "exceptions": [
    ],
  • "status": "active",
  • "shippingAddress": {
    },
  • "customFields": [
    ],
  • "extContactId": "string",
  • "internal": {
    },
  • "name": "string",
  • "tags": [
    ],
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Contact

Uniqueness constraints within organization:

  • contact.extContactId (when defined)
Authorizations:
Pipe17KeyAuth
Request Body schema:
required
object (Address)
Array of objects (ContactCustomField)
extContactId
string

Contact external ID

object (InternalInfo)

Internal info

name
string

Contact name

tags
Array of strings (EntityTags)

Tags assigned to entity

Responses

Request samples

Content type
{
  • "shippingAddress": {
    },
  • "customFields": [
    ],
  • "extContactId": "string",
  • "internal": {
    },
  • "name": "string",
  • "tags": [
    ]
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "contact": {
    }
}

Delete Contact

Authorizations:
Pipe17KeyAuth
path Parameters
ContactId
required
string

ID or ext:{extContactId} of contact to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Contact

Authorizations:
Pipe17KeyAuth
path Parameters
ContactId
required
string

ID or ext:{extContactId} of contact to fetch

query Parameters
sourceDocVersion
number

Fetch specific vendor source doc version if available

withSourceDoc
boolean

Include vendor source doc if available

withSourceDocVersions
boolean

Include available vendor source doc versions

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "contact": {
    }
}

List Contacts

Authorizations:
Pipe17KeyAuth
query Parameters
contactId
Array of strings

Retrieve by list of contactId

count
integer <int32>
Default: 100

Return at most this many contacts

emailAddr
Array of strings

Retrieve by list of shippingAddress.email

exceptionCategoryId
Array of strings

Retrieve contacts by list of categories of the contact related exceptions

exceptionType
Array of strings

Retrieve contacts by list of types of the contact related exceptions ({exceptionType} | {entityType}_{exceptionType})

extContactId
Array of strings

Retrieve by list of extContactId

keys
string
Default: "contactId,status,extContactId,createdAt,updatedAt,orgKey"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Retrieve contacts created after this date-time

skip
integer <int32>
Default: 0

Skip this many contacts

status
string (ContactStatus)
Enum: "active" "deleted"

Retrieve by status

until
string <date-time>

Retrieve contacts created before this date-time

updatedSince
string <date-time>

Retrieve contacts updated after this date-time

updatedUntil
string <date-time>

Retrieve contacts updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "contacts": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Update Contact

Uniqueness constraints within organization:

  • contact.extContactId (when defined)
Authorizations:
Pipe17KeyAuth
path Parameters
ContactId
required
string

ID or ext:{extContactId} of contact to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
Array of objects or null (ContactCustomField)
extContactId
string

Contact external ID

object (InternalInfo)

Internal info

name
string

Contact name

object (AddressUpdateData)
tags
Array of strings (EntityTags)

Tags assigned to entity

Responses

Request samples

Content type
{
  • "customFields": [
    ],
  • "extContactId": "string",
  • "internal": {
    },
  • "name": "string",
  • "shippingAddress": {
    },
  • "tags": [
    ]
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "contact": {
    }
}

Customers

Operations about customers

Customer Model

Array of objects (CustomerAddress)
object (CustomerBillingAddress)
catalogIds
Array of strings
object (CustomerCheckoutSettings)

Customer checkout settings

company
string

Customer company name

createdAt
string <date-time>

When the object was created within Pipe17

customerId
string

Customer ID

Array of objects (CustomerCustomField)
displayName
string

Customer display name

email
string

Customer email

exceptions
Array of strings

References to exceptions related to the customer

extCustomerId
string

Customer external ID

firstName
string

Customer first name

object (InternalInfo)

Internal info

lastName
string

Customer last name

Array of objects (CustomerLink)

References to parent customer objects(s) and assigned role(s) of individual in parent customer

notes
string
orgKey
string

Organization this object belong to

object (CustomerPaymentTerms)

Customer payment terms

phone
string

Customer phone

object (CustomerShippingAddress)
object (SourceDoc)

Vendor source document

status
string
Enum: "active" "inactive" "deleted"

Customer status

tags
Array of strings
object (CustomerTaxOptions)

Customer tax options

type
string (CustomerType)
Enum: "individual" "company" "company_location" "other"

Customer type

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "customerId": "string",
  • "exceptions": [
    ],
  • "status": "active",
  • "addresses": [
    ],
  • "billingAddress": {
    },
  • "catalogIds": [
    ],
  • "checkoutSettings": {
    },
  • "company": "string",
  • "customFields": [
    ],
  • "displayName": "string",
  • "email": "string",
  • "extCustomerId": "string",
  • "firstName": "string",
  • "internal": {
    },
  • "lastName": "string",
  • "linkedCustomers": [
    ],
  • "notes": "string",
  • "paymentTerms": {
    },
  • "phone": "string",
  • "shippingAddress": {
    },
  • "sourceDoc": {
    },
  • "tags": [
    ],
  • "taxOptions": {
    },
  • "type": "individual",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Customer

Uniqueness constraints within organization:

  • customer.extCustomerId (when defined)
Authorizations:
Pipe17KeyAuth
Request Body schema:
Array of objects (CustomerAddress)
object (CustomerBillingAddress)
catalogIds
Array of strings
object (CustomerCheckoutSettings)

Customer checkout settings

company
string

Customer company name

Array of objects (CustomerCustomField)
displayName
string

Customer display name

email
string

Customer email

extCustomerId
string

Customer external ID

firstName
string

Customer first name

object (InternalInfo)

Internal info

lastName
string

Customer last name

Array of objects (CustomerLink)

References to parent customer objects(s) and assigned role(s) of individual in parent customer

notes
string
object (CustomerPaymentTerms)

Customer payment terms

phone
string

Customer phone

object (CustomerShippingAddress)
object (SourceDoc)

Vendor source document

status
string (CustomerStatus)
Enum: "active" "inactive" "deleted"

Customer status

tags
Array of strings
object (CustomerTaxOptions)

Customer tax options

type
string (CustomerType)
Enum: "individual" "company" "company_location" "other"

Customer type

Responses

Request samples

Content type
{
  • "addresses": [
    ],
  • "billingAddress": {
    },
  • "catalogIds": [
    ],
  • "checkoutSettings": {
    },
  • "company": "string",
  • "customFields": [
    ],
  • "displayName": "string",
  • "email": "string",
  • "extCustomerId": "string",
  • "firstName": "string",
  • "internal": {
    },
  • "lastName": "string",
  • "linkedCustomers": [
    ],
  • "notes": "string",
  • "paymentTerms": {
    },
  • "phone": "string",
  • "shippingAddress": {
    },
  • "sourceDoc": {
    },
  • "status": "active",
  • "tags": [
    ],
  • "taxOptions": {
    },
  • "type": "individual"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "customer": {
    }
}

Delete Customer

Authorizations:
Pipe17KeyAuth
path Parameters
CustomerId
required
string

ID or ext:{extCustomerId} of customer to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Delete Multiple Customers

Authorizations:
Pipe17KeyAuth
query Parameters
action
string (ListDeleteAction)
Default: "list"
Enum: "list" "soft"

Return the list of what to delete, or delete softly

count
integer <int32>
Default: 100

Delete at most this many customers

customerId
Array of strings

Delete customers by list of customerId

deleted
boolean

Delete soft deleted customers

extCustomerId
Array of strings

Delete customers by list of extCustomerId

orgMode
Array of strings (OrganizationMode)
Items Enum: "sandbox" "production" "internal" "demo"

Delete customers assigned these orgModes.

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Delete customers created after this date-time

skip
integer <int32>
Default: 0

Skip this many customers

status
string (CustomerStatus)
Enum: "active" "inactive" "deleted"

Delete by status

until
string <date-time>

Delete customers created before this date-time

updatedSince
string <date-time>

Delete customers updated after this date-time

updatedUntil
string <date-time>

Delete customers updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "customers": [
    ],
  • "deleted": 0,
  • "filters": {
    },
  • "pagination": {
    }
}

Fetch Customer

Authorizations:
Pipe17KeyAuth
path Parameters
CustomerId
required
string

ID or ext:{extCustomerId} of customer to fetch

query Parameters
sourceDocVersion
number

Fetch specific vendor source doc version if available

withSourceDoc
boolean

Include vendor source doc if available

withSourceDocVersions
boolean

Include available vendor source doc versions

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "customer": {
    }
}

List Customers

Authorizations:
Pipe17KeyAuth
query Parameters
catalogIds
Array of strings

Retrieve by list of assigned catalog Ids

company
string

Retrieve customers by company name (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

count
integer <int32>
Default: 100

Return at most this many customers

customerId
Array of strings

Retrieve by list of customerId

deleted
boolean

Retrieve soft deleted customers

displayName
string

Retrieve customers by displayName (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

email
string

Retrieve customers by email (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

emailAddr
Array of strings

Retrieve by list of billing/shippingAddress.email (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

exceptionCategoryId
Array of strings

Retrieve customers by list of categories of the customer related exceptions

exceptionType
Array of strings

Retrieve customers by list of types of the customer related exceptions ({exceptionType} | {entityType}_{exceptionType})

extCustomerId
Array of strings

Retrieve by list of extCustomerId

firstName
string

Retrieve customers by firstName (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

hasSourceDoc
boolean

Retrieve customers containing a source document

keys
string
Default: "customerId,status,firstName,lastName,extCustomerId,displayName,shippingAddress,billingAddress,creditCard,createdAt,updatedAt,orgKey"

Return these top-level fields

lastName
string

Retrieve customers by lastName (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

linkedCustomerId
Array of strings

Retrieve by list of linked customerId

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

phone
string

Retrieve customers by phone (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

since
string <date-time>

Retrieve customers created after this date-time

skip
integer <int32>
Default: 0

Skip this many customers

status
string (CustomerStatus)
Enum: "active" "inactive" "deleted"

Retrieve by status

type
string (CustomerType)
Enum: "individual" "company" "company_location" "other"

Retrieve by status

until
string <date-time>

Retrieve customers created before this date-time

updatedSince
string <date-time>

Retrieve customers updated after this date-time

updatedUntil
string <date-time>

Retrieve customers updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "customers": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Sync Customers

Trigger the customers sync

Authorizations:
Pipe17KeyAuth
path Parameters
CustomerId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Customer

Uniqueness constraints within organization:

  • customer.extCustomerId (when defined)
Authorizations:
Pipe17KeyAuth
path Parameters
CustomerId
required
string

ID or ext:{extCustomerId} of customer to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
Array of objects or null (CustomerAddress)
object (CustomerBillingAddress)
catalogIds
Array of strings or null
object (CustomerCheckoutSettings)

Customer checkout settings

company
string

Customer company name

Array of objects (CustomerCustomField)
displayName
string

Customer display name

email
string

Customer email

extCustomerId
string

Customer external ID

object (InternalInfo)

Internal info

Array of objects or null (CustomerLink)

References to parent customer objects(s) and assigned role(s) of individual in parent customer

notes
string
object (CustomerPaymentTerms)

Customer payment terms

phone
string

Customer phone

object (CustomerShippingAddress)
object (SourceDoc)

Vendor source document

status
string (CustomerStatus)
Enum: "active" "inactive" "deleted"

Customer status

tags
Array of strings
object (CustomerTaxOptions)

Customer tax options

Responses

Request samples

Content type
{
  • "addresses": [
    ],
  • "billingAddress": {
    },
  • "catalogIds": [
    ],
  • "checkoutSettings": {
    },
  • "company": "string",
  • "customFields": [
    ],
  • "displayName": "string",
  • "email": "string",
  • "extCustomerId": "string",
  • "internal": {
    },
  • "linkedCustomers": [
    ],
  • "notes": "string",
  • "paymentTerms": {
    },
  • "phone": "string",
  • "shippingAddress": {
    },
  • "sourceDoc": {
    },
  • "status": "active",
  • "tags": [
    ],
  • "taxOptions": {
    }
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "customer": {
    }
}

Fulfillments

When shipments gets fulfilled, a Fulfillment object is created within Pipe17

Fulfillment Model

Array of objects (FulfillmentAcknowledgment)

Integrations acknowledgement info for this fulfillment

object

...???...

actualShipDate
string <date-time>

Actual ship date

autoEngUpdateStatus
string (AutoEngUpdateStatus)
Enum: "pending" "updated" "none"

A status that indicates whether or not the automation engine may update the entity sometime in the future. Only set internally. Useful for services such as the order routing engine where the user intended order state is critical before action. Used for orders and shipments.

Status definitions:

  • pending: the automation engine will make an update to this entity in the future.
  • updated: the automation engine has successfully made an update to this entity.
  • none: No status to set because the org did not have an enabled automation at the time of create/update.
billOfLading
string
createdAt
string <date-time>

When the object was created within Pipe17

Array of objects (NameValue)

Custom Fields

dimensionsUnit
string
Enum: "cm" "in" "ft"

Dimensions UOM

exceptions
Array of strings

References to exceptions related to the fulfillment

expectedArrivalDate
string <date-time>

Expected arrival date

extFulfillmentId
string

Reference to fulfillment on external system (vendor)

extOrderId
string

External customer friendly ID

fulfillmentId
string

Fulfillment ID

fulfillmentType
string (FulfillmentType)
Enum: "accepted" "rejected" "voided"
height
number <float>

Height

integration
string

Reference to integration that created an item

object (InternalInfo)

Internal info

length
number <float>

Length

Array of objects (FulfillmentItemExt)
locationId
string

locationId of the fulfillment

orderIntegration
string

Reference to integration that created order tied to an item

orgKey
string

Organization this object belong to

sacCode
string
shipmentId
string

Internal Pipe17 ID of the Shipment

shipmentIntegration
string

Reference to integration that created shipment tied to an item

shippingCarrier
string

Shipping Carrier

shippingCharge
number <float>

Shipping Charge

shippingClass
string

Shipping Class

object (SourceDoc)

Vendor source document

ssccCode
string
tags
Array of strings (EntityTags)

Tags assigned to entity

Array of ArrivalChangelogEntry (object) or FulfillmentChangelogEntry (object) or ReceiptChangelogEntry (object) or ShipmentChangelogEntry (object) (ChangelogEntry)

Timeline of updates

trackedAtSourceChannel
boolean

Whether tracking number were issued by source channel and thus fulfillment reporting is not required

trackingNumber
Array of strings

Tracking number(s). Not required when fulfillmentType is rejected or void.

trackingURLs
Array of strings

Tracking url(s)

ucc128
string
updatedAt
string <date-time>

When the object was updated within Pipe17

weight
number <float>

Weight

weightUnit
string
Enum: "lb" "oz" "kg" "g"

Weight unit

width
number <float>

Width

{
  • "acknowledgement": [
    ],
  • "acknowledgementSources": {
    },
  • "autoEngUpdateStatus": "pending",
  • "exceptions": [
    ],
  • "fulfillmentId": "string",
  • "integration": "string",
  • "lineItems": [
    ],
  • "locationId": "string",
  • "orderIntegration": "string",
  • "shipmentIntegration": "string",
  • "timeline": [
    ],
  • "actualShipDate": "2019-08-24T14:15:22Z",
  • "billOfLading": "string",
  • "customFields": [
    ],
  • "dimensionsUnit": "cm",
  • "expectedArrivalDate": "2019-08-24T14:15:22Z",
  • "extFulfillmentId": "string",
  • "extOrderId": "string",
  • "fulfillmentType": "accepted",
  • "height": 0,
  • "internal": {
    },
  • "length": 0,
  • "sacCode": "string",
  • "shipmentId": "string",
  • "shippingCarrier": "string",
  • "shippingCharge": 0,
  • "shippingClass": "string",
  • "sourceDoc": {
    },
  • "ssccCode": "string",
  • "tags": [
    ],
  • "trackedAtSourceChannel": true,
  • "trackingNumber": [
    ],
  • "trackingURLs": [
    ],
  • "ucc128": "string",
  • "weight": 0,
  • "weightUnit": "lb",
  • "width": 0,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Acknowledge Fulfillments

Acknowledges delivery of fulfillment information by integration

Authorizations:
Pipe17KeyAuth
path Parameters
FulfillmentId
required
Array of strings

Id or ext:{extFulfillmentId} of fulfillment to acknowledge

Request Body schema:
integration
string

Acknowledging integration

Responses

Request samples

Content type
{
  • "integration": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Create Fulfillments

Uniqueness constraints within organization:

  • fulfillment.extFulfillmentId (when defined)
Authorizations:
Pipe17KeyAuth
Request Body schema:
Array (<= 10 items)
shipmentId
required
string

Internal Pipe17 ID of the Shipment

trackingNumber
required
Array of strings

Tracking number(s). Not required when fulfillmentType is rejected or void.

actualShipDate
string <date-time>

Actual ship date

billOfLading
string
Array of objects (NameValue)

Custom Fields

dimensionsUnit
string
Enum: "cm" "in" "ft"

Dimensions UOM

expectedArrivalDate
string <date-time>

Expected arrival date

extFulfillmentId
string

Reference to fulfillment on external system (vendor)

extOrderId
string

External customer friendly ID

fulfillmentType
string (FulfillmentType)
Enum: "accepted" "rejected" "voided"
height
number <float>

Height

object (InternalInfo)

Internal info

length
number <float>

Length

Array of objects (FulfillmentItem)
locationId
string

locationId of the fulfillment

sacCode
string
shippingCarrier
string

Shipping Carrier

shippingCharge
number <float>

Shipping Charge

shippingClass
string

Shipping Class

object (SourceDoc)

Vendor source document

ssccCode
string
tags
Array of strings (EntityTags)

Tags assigned to entity

trackedAtSourceChannel
boolean

Whether tracking number were issued by source channel and thus fulfillment reporting is not required

trackingURLs
Array of strings

Tracking url(s)

ucc128
string
weight
number <float>

Weight

weightUnit
string
Enum: "lb" "oz" "kg" "g"

Weight unit

width
number <float>

Width

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "fulfillments": [
    ]
}

Fetch Fulfillment

Authorizations:
Pipe17KeyAuth
path Parameters
FulfillmentId
required
string

Id or ext:{extFulfillmentId} of fulfillment to fetch

query Parameters
sourceDocVersion
number

Fetch specific vendor source doc version if available

withSourceDoc
boolean

Include vendor source doc if available

withSourceDocVersions
boolean

Include available vendor source doc versions

withTimeline
boolean

Include timeline of updates when available

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "fulfillment": {
    }
}

List Fulfillments

Authorizations:
Pipe17KeyAuth
query Parameters
acknowledgedBy
Array of strings

Fulfillments by list of acknowledged integrations

autoEngUpdateStatus
Array of strings (AutoEngUpdateStatus)
Items Enum: "pending" "updated" "none"
count
integer <int32>
Default: 100

Return at most this many fulfillments

exceptionCategoryId
Array of strings

Fulfillments by list of categories of the fulfillment related exceptions

exceptionType
Array of strings

Fulfillments by list of types of the fulfillment related exceptions ({exceptionType} | {entityType}_{exceptionType})

extFulfillmentId
Array of strings

Fulfillments by list of extFulfillmentId

extOrderId
Array of strings

Fulfillments by list of extShipmentId

extShipmentId
Array of strings

Fulfillments by list of extShipmentId

fulfillmentId
Array of strings

Fulfillments by list of fulfillmentId

fulfillmentType
Array of strings (FulfillmentType)
Items Enum: "accepted" "rejected" "voided"

Fulfillments by list of fulfillment types

hasSourceDoc
boolean

Fulfillments containing a source document

integration
Array of strings

Fulfillments by list of integrationId

keys
string
Default: "fulfillmentId,fulfillmentType,shipmentId,extOrderId,actualShipDate,createdAt,updatedAt,orgKey"

Return these top-level fields

locationId
Array of strings

Fulfillments by list of locationId

order
string
Default: "createdAt"

Sort by these top-level fields

orderIntegration
Array of strings

Fulfillments by list of order integrationId

orderIntegrationAcknowledged
boolean

Fulfillments by order integration acknowledgement

pagination
string
Value: "disabled"

Exclude pagination info from the response

shipmentId
Array of strings

Fulfillments by list of shipmentId

since
string <date-time>

Fetch all fulfillments created after this date-time

skip
integer <int32>
Default: 0

Skip this many fulfillments

until
string <date-time>

Fetch all fulfillments created before this date-time

updatedSince
string <date-time>

Fetch all fulfillments updated after this date-time

updatedUntil
string <date-time>

Fetch all fulfillments updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "fulfillments": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Sync Fulfillments

Trigger the fulfillments sync

Authorizations:
Pipe17KeyAuth
path Parameters
FulfillmentId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Inventory

Operations about Inventory

Inventory Model

available
integer <int32>

Number of items available

availableToPromise
integer <int32>

Number of items available to promise

commitShip
integer <int32>

Number of items being shipped (included in committed)

committed
integer <int32>

Number of items committed

committedFuture
integer <int32>

Number of items committed for pre-order

commitXfer
integer <int32>

Number of items being transferred out (included in committed)

createdAt
string <date-time>

When the object was created within Pipe17

damaged
integer <int32>
entityId
string

Related entity ID

entityType
string

Related entity ID's type

event
string (EventType)
Enum: "ingest" "adjust" "custom" "ship" "fulfill" "xferin" "xferout" "return" "receive" "xferfulfill" "futureShip" "release" "shipCancel" "shipCancelRestock" "futureShipCancel" "virtualCommit" "touch" "POSOrder"

Type of event triggering inventory change:

  • ingest - Indicates quantities reported by fulfillment channel (warehouse).
  • adjust - Manual inventory update or result of bundle quantities update by Inventory Engine.
  • touch - Simulated inventory update not tied with quantity changes. Initiates inventory sync and/or recalculation process.
  • POSOrder - Includes quantity updates of inventory item referred in POS order. Reduces available, onHand.
  • virtualCommit - Includes quantity updates of inventory item referred in sales order or shipping request. Indicates the difference between order quantity and shipment(s) quantity. Used to adjust available and committed in the virtual location to maintain inventory totals prior to creation of shipping request.
  • ship - Includes quantity updates of inventory item referred in sales order shipping request. Reduces available, increases committed and commitShip.
  • shipCancel - Includes quantity updates of inventory item referred in canceled sales order shipping request (excluding futureShipCancel case). Decreases committed, adjusts onHand and commitShip.
  • shipCancelRestock - Includes quantity updates of inventory item referred in canceled sales order shipping request with canceledRestock status. Reduces committed, increases available, adjusts commitShip.
  • fulfill - Includes quantity updates of inventory item referred in sales order fulfillment. Reduces committed, onHand, commitShip.
  • futureShip - Includes quantity updates of inventory item referred in sales order shipping request assigned pendingInventory status. Increases committedFuture.
  • release - Includes quantity updates of inventory item referred in sales order shipping request once it transitions from pendingInventory to readyForFulfillment status. Transfers quantity from committedFuture to committed, adjusts available and commitShip.
  • futureShipCancel - Includes quantity updates of inventory item referred in canceled sales order shipping request which was once assigned pendingInventory status. Reduces committedFuture.
  • xferout - Includes quantity updates of inventory item referred in transfer order shipping request with readyForFulfillment status. Reduces available, increases committed, adjusts commitXfer.
  • xferfulfill - Includes quantity updates of inventory item referred in transfer order fulfillment. Reduces committed, onHand, commitXfer.
  • xferin - Includes quantity updates of inventory item referred in arrival. Increases incoming quantity.
  • receive - Includes quantity updates of inventory item referred in receipt. Increases available, decreases incoming, adjusts onHand and future.
exceptions
Array of strings

References to exceptions related to the inventory

future
integer <int32>

Number of items that can be sold for pre-order

hold
integer <int32>
incoming
integer <int32>

Number of incoming items in transit (maybe included in available)

integration
string

Reference to integration that created an item

inventoryId
string

Inventory ID

inventoryNotTracked
boolean

Disables the inventory tracking

label
string
locationId
string

Location of item

onHand
integer <int32>

Number of items on hand

orderId
string

Pipe17 internal order id that initiated this inventory change

orderType
string

Type of order that initiated this inventory change

orgKey
string

Organization this object belong to

quantity
integer <int32>

Number of items affected

sku
string

Item SKU

type
string
Enum: "virtual" "physical"

Inventory type (undefined value indicates a physical inventory)

unavailable
integer <int32>

Number of unavailable items

updatedAt
string <date-time>

When the object was updated within Pipe17

user
string

Pipe17 internal id of the user who makes the inventory adjustment via the portal

vendorSKU
string

Item vendor SKU

{
  • "available": 0,
  • "availableToPromise": 0,
  • "commitShip": 0,
  • "commitXfer": 0,
  • "committed": 0,
  • "committedFuture": 0,
  • "damaged": 0,
  • "entityId": "string",
  • "entityType": "string",
  • "event": "ingest",
  • "exceptions": [
    ],
  • "future": 0,
  • "hold": 0,
  • "incoming": 0,
  • "integration": "string",
  • "inventoryId": "string",
  • "inventoryNotTracked": true,
  • "label": "string",
  • "locationId": "string",
  • "onHand": 0,
  • "orderId": "string",
  • "orderType": "string",
  • "quantity": 0,
  • "sku": "string",
  • "type": "virtual",
  • "unavailable": 0,
  • "user": "string",
  • "vendorSKU": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Inventory Log Items

Uniqueness constraints:

  • inventory.event, inventory.entityId, inventory.sku (when entityId and materialEvent defined)
Authorizations:
Pipe17KeyAuth
Request Body schema:
Array (<= 10 items)
committed
required
integer <int32>

Number of items committed

event
required
string
Enum: "ingest" "adjust"

Event creating this item

locationId
required
string

Location ID of item

onHand
required
integer <int32>

Number of items on hand

ptype
required
string (EventSource)
Enum: "wms" "ims" "oms" "portal"

Event source partner type

sku
required
string

Item SKU

available
integer <int32>

Number of items available

commitShip
integer <int32>

Number of items being shipped (included in committed)

committedFuture
integer <int32>

Number of items committed for pre-order

commitXfer
integer <int32>

Number of items being transferred out (included in committed)

damaged
integer <int32>
future
integer <int32>

Number of items that can be sold for pre-order

hold
integer <int32>
incoming
integer <int32>

Number of incoming items in transit (maybe included in available)

inventoryNotTracked
boolean

Disables the inventory tracking (default - false)

type
string
Enum: "virtual" "physical"

Inventory type

unavailable
integer <int32>

Number of unavailable items

vendorSKU
string

Item vendor SKU

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "inventory": [
    ]
}

Fetch Inventory Log Item

Authorizations:
Pipe17KeyAuth
path Parameters
InventoryId
required
string

Inventory Item ID to fetch

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "inventory": {
    }
}

List Inventory Log Items

Authorizations:
Pipe17KeyAuth
query Parameters
available
integer

Fetch inventory if 'available' value is equal to specified one

available_gt
integer

Fetch inventory if 'available' value is greater than specified one

available_lt
integer

Fetch inventory if 'available' value is less than specified one

count
integer <int32>
Default: 100

Return at most this many inventory items

entityId
Array of strings

Return inventory items related to certain event record by record id

event
Array of strings (EventType)
Items Enum: "ingest" "adjust" "custom" "ship" "fulfill" "xferin" "xferout" "return" "receive" "xferfulfill" "futureShip" "release" "shipCancel" "shipCancelRestock" "futureShipCancel" "virtualCommit" "touch" "POSOrder"

Fetch inventory by event list (- allowed only with 'ledger' flag)

exceptionCategoryId
Array of strings

Fetch inventory by list of categories of the inventory related exceptions (- ignored in 'totals' queries)

exceptionType
Array of strings

Fetch inventory by list of types of the inventory related exceptions (- ignored in 'totals' queries)

integration
Array of strings

Fetch inventory by integrations id list (- ignored in 'totals' queries)

inventoryId
Array of strings

Inventory items by list of inventoryId

inventoryNotTracked
boolean

Fetch inventory by the inventoryNotTracked value (- ignored in 'totals' queries)

keys
string
Default: "All"

Return these top-level fields

ledger
boolean

Return inventory ledger information

locationId
Array of strings

Fetch inventory by its location ID

onHand
integer

Fetch inventory if 'onHand' value is equal to specified one

onHand_gt
integer

Fetch inventory if 'onHand' value is greater than specified one

onHand_lt
integer

Fetch inventory if 'onHand' value is less than specified one

order
string
Default: "-updatedAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

requestorId
string

Id of the inventory totals requestor (- used to select availble locations; forcibly replaced with integration ID if the request came from an integration)

since
string <date-time>

Inventory created after this date,time

skip
integer <int32>
Default: 0

Skip this many inventory items

sku
Array of strings

Fetch inventory by its SKU

sku_gt
string

Fetch inventory in which SKU is lexicographically greater than the specified value

sku_lt
string

Fetch inventory in which SKU is lexicographically less than the specified value

totals
boolean

Return inventory totals across all locations

type
string
Enum: "virtual" "physical"

'virtual' - fetch virtual inventory status, 'physical' - not virtual (it is unallowable parameter when used with 'ledger' or 'totals' flag)

until
string <date-time>

Inventory created before this date,time

updatedSince
string <date-time>

Inventory updated after this date-time

updatedUntil
string <date-time>

Inventory updated before this date-time

vendorSKU
Array of strings

Fetch inventory by its vendorSKU

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "inventory": [
    ],
  • "locationId": [
    ],
  • "pagination": {
    }
}

Sync Inventory

Trigger the inventory sync

Authorizations:
Pipe17KeyAuth
path Parameters
InventoryId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Inventory

Uniqueness constraints:

  • inventory.event, inventory.entityId, inventory.sku (when entityId and materialEvent defined)
Authorizations:
Pipe17KeyAuth
query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
event
required
string
Enum: "ship" "fulfill" "xferout" "xferfulfill" "xferin" "receive" "futureShip" "release" "shipCancel" "shipCancelRestock" "futureShipCancel" "virtualCommit" "touch" "POSOrder" "custom"

Event updating inventory

locationId
required
string

Location Id of item

ptype
required
string (EventSource)
Enum: "wms" "ims" "oms" "portal"

Event source partner type

quantity
required
integer <int32>

Number of items affected

sku
required
string

Item SKU

entityId
string

Entity id of the record which is directly related to this inventory change

entityType
string
Enum: "arrivals" "fulfillments" "inventory" "receipts" "shipments" "orders"

Type of the record which is directly related to this inventory change

infinite
boolean

Set if item location has "infinite" availability

inventoryNotTracked
boolean or null

Disables the inventory tracking

label
string
orderId
string

Pipe17 internal order id that initiated this inventory change

orderType
string
Enum: "sales" "transfer" "purchase"

Type of order that initiated this inventory change

type
string
Enum: "virtual" "physical"

Inventory type

vendorSKU
string

Item vendor SKU

Responses

Request samples

Content type
{
  • "event": "ship",
  • "locationId": "string",
  • "ptype": "wms",
  • "quantity": 0,
  • "sku": "string",
  • "entityId": "string",
  • "entityType": "arrivals",
  • "infinite": true,
  • "inventoryNotTracked": true,
  • "label": "string",
  • "orderId": "string",
  • "orderType": "sales",
  • "type": "virtual",
  • "vendorSKU": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "inventory": {
    }
}

Inventory Rules

Operations about Inventory Rules

Inventory Rule Model

event
required
string (EventType)
Enum: "ingest" "adjust" "custom" "ship" "fulfill" "xferin" "xferout" "return" "receive" "xferfulfill" "futureShip" "release" "shipCancel" "shipCancelRestock" "futureShipCancel" "virtualCommit" "touch" "POSOrder"

Type of event triggering inventory change:

  • ingest - Indicates quantities reported by fulfillment channel (warehouse).
  • adjust - Manual inventory update or result of bundle quantities update by Inventory Engine.
  • touch - Simulated inventory update not tied with quantity changes. Initiates inventory sync and/or recalculation process.
  • POSOrder - Includes quantity updates of inventory item referred in POS order. Reduces available, onHand.
  • virtualCommit - Includes quantity updates of inventory item referred in sales order or shipping request. Indicates the difference between order quantity and shipment(s) quantity. Used to adjust available and committed in the virtual location to maintain inventory totals prior to creation of shipping request.
  • ship - Includes quantity updates of inventory item referred in sales order shipping request. Reduces available, increases committed and commitShip.
  • shipCancel - Includes quantity updates of inventory item referred in canceled sales order shipping request (excluding futureShipCancel case). Decreases committed, adjusts onHand and commitShip.
  • shipCancelRestock - Includes quantity updates of inventory item referred in canceled sales order shipping request with canceledRestock status. Reduces committed, increases available, adjusts commitShip.
  • fulfill - Includes quantity updates of inventory item referred in sales order fulfillment. Reduces committed, onHand, commitShip.
  • futureShip - Includes quantity updates of inventory item referred in sales order shipping request assigned pendingInventory status. Increases committedFuture.
  • release - Includes quantity updates of inventory item referred in sales order shipping request once it transitions from pendingInventory to readyForFulfillment status. Transfers quantity from committedFuture to committed, adjusts available and commitShip.
  • futureShipCancel - Includes quantity updates of inventory item referred in canceled sales order shipping request which was once assigned pendingInventory status. Reduces committedFuture.
  • xferout - Includes quantity updates of inventory item referred in transfer order shipping request with readyForFulfillment status. Reduces available, increases committed, adjusts commitXfer.
  • xferfulfill - Includes quantity updates of inventory item referred in transfer order fulfillment. Reduces committed, onHand, commitXfer.
  • xferin - Includes quantity updates of inventory item referred in arrival. Increases incoming quantity.
  • receive - Includes quantity updates of inventory item referred in receipt. Increases available, decreases incoming, adjusts onHand and future.
rule
required
string

Rule's definition as javascript function

createdAt
string <date-time>

When the object was created within Pipe17

description
string

Description of the rule

integration
string

Event source integration id

object (InternalInfo)

Internal info

orgKey
string

Organization this object belong to

partner
string

Event source partner name

ptype
string (EventSource)
Enum: "wms" "ims" "oms" "portal"

Event source partner type

ruleId
string

Rule ID

status
string

Rule status

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "ruleId": "string",
  • "status": "string",
  • "event": "ingest",
  • "rule": "string",
  • "description": "string",
  • "integration": "string",
  • "internal": {
    },
  • "partner": "string",
  • "ptype": "wms",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Inventory Rule

Uniqueness constraints:

  • rule.event, rule.ptype, rule.partner, rule.integration
Authorizations:
Pipe17KeyAuth
Request Body schema:
event
required
string (EventType)
Enum: "ingest" "adjust" "custom" "ship" "fulfill" "xferin" "xferout" "return" "receive" "xferfulfill" "futureShip" "release" "shipCancel" "shipCancelRestock" "futureShipCancel" "virtualCommit" "touch" "POSOrder"

Type of event triggering inventory change:

  • ingest - Indicates quantities reported by fulfillment channel (warehouse).
  • adjust - Manual inventory update or result of bundle quantities update by Inventory Engine.
  • touch - Simulated inventory update not tied with quantity changes. Initiates inventory sync and/or recalculation process.
  • POSOrder - Includes quantity updates of inventory item referred in POS order. Reduces available, onHand.
  • virtualCommit - Includes quantity updates of inventory item referred in sales order or shipping request. Indicates the difference between order quantity and shipment(s) quantity. Used to adjust available and committed in the virtual location to maintain inventory totals prior to creation of shipping request.
  • ship - Includes quantity updates of inventory item referred in sales order shipping request. Reduces available, increases committed and commitShip.
  • shipCancel - Includes quantity updates of inventory item referred in canceled sales order shipping request (excluding futureShipCancel case). Decreases committed, adjusts onHand and commitShip.
  • shipCancelRestock - Includes quantity updates of inventory item referred in canceled sales order shipping request with canceledRestock status. Reduces committed, increases available, adjusts commitShip.
  • fulfill - Includes quantity updates of inventory item referred in sales order fulfillment. Reduces committed, onHand, commitShip.
  • futureShip - Includes quantity updates of inventory item referred in sales order shipping request assigned pendingInventory status. Increases committedFuture.
  • release - Includes quantity updates of inventory item referred in sales order shipping request once it transitions from pendingInventory to readyForFulfillment status. Transfers quantity from committedFuture to committed, adjusts available and commitShip.
  • futureShipCancel - Includes quantity updates of inventory item referred in canceled sales order shipping request which was once assigned pendingInventory status. Reduces committedFuture.
  • xferout - Includes quantity updates of inventory item referred in transfer order shipping request with readyForFulfillment status. Reduces available, increases committed, adjusts commitXfer.
  • xferfulfill - Includes quantity updates of inventory item referred in transfer order fulfillment. Reduces committed, onHand, commitXfer.
  • xferin - Includes quantity updates of inventory item referred in arrival. Increases incoming quantity.
  • receive - Includes quantity updates of inventory item referred in receipt. Increases available, decreases incoming, adjusts onHand and future.
rule
required
string

Rule's definition as javascript function

description
string

Description of the rule

integration
string

Event source integration id

object (InternalInfo)

Internal info

partner
string

Event source partner name

ptype
string (EventSource)
Enum: "wms" "ims" "oms" "portal"

Event source partner type

Responses

Request samples

Content type
{
  • "event": "ingest",
  • "rule": "string",
  • "description": "string",
  • "integration": "string",
  • "internal": {
    },
  • "partner": "string",
  • "ptype": "wms"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "inventoryrule": {
    }
}

Delete Inventory Rule

Authorizations:
Pipe17KeyAuth
path Parameters
RuleId
required
string

Rule ID to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Delete Multiple InventoryRules

Authorizations:
Pipe17KeyAuth
query Parameters
action
string (ListDeleteAction)
Default: "list"
Enum: "list" "soft"

Return the list of what to delete, or delete softly

count
integer <int32>
Default: 100

Max number of items to delete

deleted
boolean

Delete soft deleted rules

integration
Array of strings

Delete rules by list of integration ids

orgMode
Array of strings (OrganizationMode)
Items Enum: "sandbox" "production" "internal" "demo"

Delete rules assigned these orgModes.

pagination
string
Value: "disabled"

Exclude pagination info from the response

ruleId
Array of strings

Delete rules by list of ruleId

since
string <date-time>

Delete rules created after this date-time

skip
integer <int32>
Default: 0

Number of items to skip

until
string <date-time>

Delete rules created before this date-time

updatedSince
string <date-time>

Delete rules updated after this date-time

updatedUntil
string <date-time>

Delete rules updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "deleted": 0,
  • "filters": {
    },
  • "pagination": {
    },
  • "rules": [
    ]
}

Fetch Inventory Rule

Authorizations:
Pipe17KeyAuth
path Parameters
RuleId
required
string

Rule ID to fetch

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "inventoryrule": {
    }
}

List Inventory Rules

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Return at most this many rules

deleted
boolean

Soft deleted rules

event
Array of strings (EventType)
Items Enum: "ingest" "adjust" "custom" "ship" "fulfill" "xferin" "xferout" "return" "receive" "xferfulfill" "futureShip" "release" "shipCancel" "shipCancelRestock" "futureShipCancel" "virtualCommit" "touch" "POSOrder"

Event types trigerring rule

integration
Array of strings

Rules by list of integration ids

keys
string
Default: "ruleId,event,ptype,partner,integration,description,rule,createdAt,updatedAt,orgKey"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

partner
Array of strings

Event source partner names

ptype
Array of strings (EventSource)
Items Enum: "wms" "ims" "oms" "portal"

Event source partner types

ruleId
Array of strings

Rules by list of ruleId

since
string <date-time>

Rules created after this date-time

skip
integer <int32>
Default: 0

Skip this many rules

until
string <date-time>

Rules created before this date-time

updatedSince
string <date-time>

Rules updated after this date-time

updatedUntil
string <date-time>

Rules updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "pagination": {
    },
  • "rules": [
    ]
}

Sync Inventory Rules

Trigger the inventory rules sync

Authorizations:
Pipe17KeyAuth
path Parameters
RuleId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Inventory Rule

Uniqueness constraints:

  • rule.event, rule.ptype, rule.partner, rule.integration
Authorizations:
Pipe17KeyAuth
path Parameters
RuleId
required
string

Rule ID to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
rule
required
string

Rule's definition as javascript function

description
string

Description of the rule

object (InternalInfo)

Internal info

Responses

Request samples

Content type
{
  • "rule": "string",
  • "description": "string",
  • "internal": {
    }
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "inventoryrule": {
    }
}

Invoices

Operations with Invoices

Invoice Model

extInvoiceId
required
string

External Invoice ID

Array of objects (InvoiceAdditionalCharge)

Additional charges

object (Address)
createdAt
string <date-time>

When the object was created within Pipe17

currency
string

Invoice currency code

object (InvoiceCustomer)
Array of objects (NameValue)

Custom Fields

Array of objects (InvoiceDiscount)

Discounts

dueAt
string <date-time>

Invoice due date

exceptions
Array of strings

References to exceptions related to the invoice

extInvoiceApiId
string

External System Invoice API ID

extInvoiceCreatedAt
string <date-time>

When the invoice was created at source

extInvoiceUpdatedAt
string <date-time>

When the invoice was updated at source

extInvoiceUrl
string

Invoice Url in External System

extOrderId
string

Reference to order

extReferenceId
string

Reference ID

integration
string

Reference to integration that created the invoice

object (InternalInfo)

Internal info

invoiceDiscount
number <float>

Invoice Discount

invoiceId
string

Auto Generated

invoiceNote
string

Invoice Notes

invoiceTax
number <float>

Invoice Tax

invoiceType
string (InvoiceType)
Enum: "bill" "invoice" "debitMemo" "creditMemo" "cashSale" "cashReturn"

Invoice Type

Array of objects (InvoiceLineItem)
orderId
string

Reference to order

orderIntegrations
Array of strings

Integrations that created orders related to the invoice

orgKey
string

Organization this object belong to

paidAt
string <date-time>

Invoice paid date

Array of objects (InvoicePayment)

Payments

paymentStatus
string

status of the payment

object (SourceDoc)

Vendor source document

status
string (InvoiceStatus)
Enum: "draft" "new" "reviewRequired" "posted" "partialPaid" "paid" "canceled" "closed"

Invoice Status

subTotalPrice
number <float>

Sub Total Price

tags
Array of strings (EntityTags)

Tags assigned to entity

term
string
totalPrice
number <float>

Total Price

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "exceptions": [
    ],
  • "integration": "string",
  • "invoiceId": "string",
  • "orderIntegrations": [
    ],
  • "extInvoiceId": "string",
  • "additionalCharges": [
    ],
  • "billingAddress": {
    },
  • "currency": "string",
  • "customFields": [
    ],
  • "customer": {
    },
  • "discounts": [
    ],
  • "dueAt": "2019-08-24T14:15:22Z",
  • "extInvoiceApiId": "string",
  • "extInvoiceCreatedAt": "2019-08-24T14:15:22Z",
  • "extInvoiceUpdatedAt": "2019-08-24T14:15:22Z",
  • "extInvoiceUrl": "string",
  • "extOrderId": "string",
  • "extReferenceId": "string",
  • "internal": {
    },
  • "invoiceDiscount": 0,
  • "invoiceNote": "string",
  • "invoiceTax": 0,
  • "invoiceType": "bill",
  • "lineItems": [
    ],
  • "orderId": "string",
  • "paidAt": "2019-08-24T14:15:22Z",
  • "paymentStatus": "string",
  • "payments": [
    ],
  • "sourceDoc": {
    },
  • "status": "draft",
  • "subTotalPrice": 0,
  • "tags": [
    ],
  • "term": "string",
  • "totalPrice": 0,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Invoices

Uniqueness constraints within organization:

  • invoice.extInvoiceId, invoice.integration
  • invoice.extInvoiceApiId, invoice.integration
  • invoice.extReferenceId, invoice.integration
Authorizations:
Pipe17KeyAuth
Request Body schema:
Array (<= 10 items)
extInvoiceId
required
string

External Invoice ID

Array of objects (InvoiceAdditionalCharge)

Additional charges

object (Address)
currency
string

Invoice currency code

object (InvoiceCustomer)
Array of objects (NameValue)

Custom Fields

Array of objects (InvoiceDiscount)

Discounts

dueAt
string <date-time>

Invoice due date

extInvoiceApiId
string

External System Invoice API ID

extInvoiceCreatedAt
string <date-time>

When the invoice was created at source

extInvoiceUpdatedAt
string <date-time>

When the invoice was updated at source

extInvoiceUrl
string

Invoice Url in External System

extOrderId
string

Reference to order

extReferenceId
string

Reference ID

object (InternalInfo)

Internal info

invoiceDiscount
number <float>

Invoice Discount

invoiceNote
string

Invoice Notes

invoiceTax
number <float>

Invoice Tax

invoiceType
string (InvoiceType)
Enum: "bill" "invoice" "debitMemo" "creditMemo" "cashSale" "cashReturn"

Invoice Type

Array of objects (InvoiceLineItem)
orderId
string

Reference to order

paidAt
string <date-time>

Invoice paid date

Array of objects (InvoicePayment)

Payments

paymentStatus
string

status of the payment

object (SourceDoc)

Vendor source document

status
string (InvoiceStatus)
Enum: "draft" "new" "reviewRequired" "posted" "partialPaid" "paid" "canceled" "closed"

Invoice Status

subTotalPrice
number <float>

Sub Total Price

tags
Array of strings (EntityTags)

Tags assigned to entity

term
string
totalPrice
number <float>

Total Price

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "invoices": [
    ]
}

Delete Invoice

Authorizations:
Pipe17KeyAuth
path Parameters
InvoiceId
required
string

Invoice identifier - invoiceId, ext:{extInvoiceId}, api:{extInvoiceApiId}, or ref:{extReferenceId}

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Delete Multiple Invoices

Authorizations:
Pipe17KeyAuth
query Parameters
action
string (ListDeleteAction)
Default: "list"
Enum: "list" "soft"

Return the list of what to delete, or delete softly

count
integer <int32>
Default: 100

Delete at most this many invoices

deleted
boolean

Select soft deleted invoices

extInvoiceId
Array of strings

Select invoices by extInvoiceId list

extOrderId
Array of strings

Select invoices by extOrderId list

extReferenceId
Array of strings

Select invoices by extReferenceId list

integration
Array of strings

Select invoices of these integrations

invoiceId
Array of strings

Select invoices by invoiceId list

orderId
Array of strings

Select invoices by orderId list

orgMode
Array of strings (OrganizationMode)
Items Enum: "sandbox" "production" "internal" "demo"

Select invoices assigned these orgModes.

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Select invoices created after this date-time

skip
integer <int32>
Default: 0

Skip this many invoices

status
Array of strings

Select invoices by status list

until
string <date-time>

Select invoices created before this date-time

updatedSince
string <date-time>

Select invoices updated after this date-time

updatedUntil
string <date-time>

Select invoices updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "deleted": 0,
  • "filters": {
    },
  • "invoices": [
    ],
  • "pagination": {
    }
}

Fetch Invoice

Authorizations:
Pipe17KeyAuth
path Parameters
InvoiceId
required
string

Invoice identifier - invoiceId, ext:{extInvoiceId}, api:{extInvoiceApiId}, or ref:{extReferenceId}

query Parameters
sourceDocVersion
number

Fetch specific vendor source doc version if available

withSourceDoc
boolean

Include vendor source doc if available

withSourceDocVersions
boolean

Include available vendor source doc versions

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "invoice": {
    }
}

List Invoices

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Return at most this many invoices

deleted
boolean

Select soft deleted invoices

emailAddr
Array of strings

Select invoices by 'billingAddress.email' list

exceptionCategoryId
Array of strings

Select invoices by list of categories of the invoice related exceptions

exceptionType
Array of strings

Select invoices by list of types of the invoice related exceptions ({exceptionType} | {entityType}_{exceptionType})

extInvoiceApiId
Array of strings
extInvoiceId
Array of strings

Select invoices by extInvoiceApiId list

extOrderId
Array of strings

Select invoices by extOrderId list

extReferenceId
Array of strings

Select invoices by extReferenceId list

hasSourceDoc
boolean

Select invoices containing a source document

invoiceId
Array of strings

Select invoices by invoiceId list

keys
string
Default: "invoiceId,extInvoiceId,extInvoiceApiId,extReferenceId,integration,status,tags,createdAt,updatedAt,orgKey"

Return these top-level fields

order
string
Default: "-extOrderCreatedAt"

Sort by these top-level fields

orderId
Array of strings

Select invoices by orderId list

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Select invoices created after this date-time

skip
integer <int32>
Default: 0

Skip this many invoices

status
Array of strings

Select invoices by status list

until
string <date-time>

Select invoices created before this date-time

updatedSince
string <date-time>

Select invoices updated after this date-time

updatedUntil
string <date-time>

Select invoices updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "invoices": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Sync Invoices

Trigger the invoice sync

Authorizations:
Pipe17KeyAuth
path Parameters
InvoiceId
required
Array of strings

Comma-separated invoiceId list

Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Invoice

Uniqueness constraints within organization:

  • invoice.extInvoiceId, invoice.integration
  • invoice.extInvoiceApiId, invoice.integration
  • invoice.extReferenceId, invoice.integration
Authorizations:
Pipe17KeyAuth
path Parameters
InvoiceId
required
string

Invoice identifier - invoiceId, ext:{extInvoiceId}, api:{extInvoiceApiId}, or ref:{extReferenceId}

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
Array of objects or null (InvoiceAdditionalCharge)

Additional charges

object (Address)
currency
string

Invoice currency code

object (InvoiceCustomer)
Array of objects (NameValue)

Custom Fields

Array of objects or null (InvoiceDiscount)

Discounts

dueAt
string <date-time>

Invoice due date

extInvoiceApiId
string

External System Invoice API ID

extInvoiceUpdatedAt
string <date-time>

When the invoice was updated at source

extInvoiceUrl
string

Invoice Url in External System

extReferenceId
string

Reference ID

object (InternalInfo)

Internal info

invoiceDiscount
number or null <float>

Invoice Discount

invoiceNote
string or null

Invoice Notes

invoiceTax
number or null <float>

Invoice Tax

invoiceType
string (InvoiceType)
Enum: "bill" "invoice" "debitMemo" "creditMemo" "cashSale" "cashReturn"

Invoice Type

Array of objects (InvoiceUpdateLineItem)
paidAt
string <date-time>

Invoice paid date

Array of objects or null (InvoicePayment)

Payments

paymentStatus
string or null

status of the payment

object (SourceDoc)

Vendor source document

status
string (InvoiceStatus)
Enum: "draft" "new" "reviewRequired" "posted" "partialPaid" "paid" "canceled" "closed"

Invoice Status

subTotalPrice
number or null <float>

Sub Total Price

tags
Array of strings (EntityTags)

Tags assigned to entity

term
string
totalPrice
number or null <float>

Total Price

Responses

Request samples

Content type
{
  • "additionalCharges": [
    ],
  • "billingAddress": {
    },
  • "currency": "string",
  • "customFields": [
    ],
  • "customer": {
    },
  • "discounts": [
    ],
  • "dueAt": "2019-08-24T14:15:22Z",
  • "extInvoiceApiId": "string",
  • "extInvoiceUpdatedAt": "2019-08-24T14:15:22Z",
  • "extInvoiceUrl": "string",
  • "extReferenceId": "string",
  • "internal": {
    },
  • "invoiceDiscount": 0,
  • "invoiceNote": "string",
  • "invoiceTax": 0,
  • "invoiceType": "bill",
  • "lineItems": [
    ],
  • "paidAt": "2019-08-24T14:15:22Z",
  • "paymentStatus": "string",
  • "payments": [
    ],
  • "sourceDoc": {
    },
  • "status": "draft",
  • "subTotalPrice": 0,
  • "tags": [
    ],
  • "term": "string",
  • "totalPrice": 0
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "invoice": {
    }
}

Jobs

Long-running jobs operations

Job Model

subType
required
string (JobSubType)
Enum: "inventory" "replenishment" "purchases" "transfers" "arrivals" "products" "organizations" "orders" "shipments" "fulfillments" "locations" "shipping_methods" "returns" "exceptions" "lookup_objects"

Job sub-type

type
required
string (JobType)
Enum: "report" "import" "prepare" "update" "delete" "export" "automation"

Job type

contentType
string

Job result content type

createdAt
string <date-time>

When the object was created within Pipe17

createdBy
string

Job requester ID

object (InternalInfo)

Internal info

jobId
string

Job ID

orgKey
string

Organization this object belong to

params
object

Job type specific parameters

progress
integer (JobProgress) [ 0 .. 100 ]

Job progress (0-100)

state
object (JobState)

This is a free form object that can be used to store any state related to the job.

status
string (JobStatus)
Enum: "submitted" "processing" "completed" "canceled" "failed"

Job status

timeout
number <int32>

Job timeout (in milliseconds)

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "createdBy": "string",
  • "jobId": "string",
  • "progress": 100,
  • "status": "submitted",
  • "subType": "inventory",
  • "type": "report",
  • "contentType": "string",
  • "internal": {
    },
  • "params": { },
  • "state": { },
  • "timeout": 0,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create long-running job

Authorizations:
Pipe17KeyAuth
Request Body schema:
subType
required
string (JobSubType)
Enum: "inventory" "replenishment" "purchases" "transfers" "arrivals" "products" "organizations" "orders" "shipments" "fulfillments" "locations" "shipping_methods" "returns" "exceptions" "lookup_objects"

Job sub-type

type
required
string (JobType)
Enum: "report" "import" "prepare" "update" "delete" "export" "automation"

Job type

contentType
string

Job result content type

object (InternalInfo)

Internal info

params
object

Job type specific parameters

state
object (JobState)

This is a free form object that can be used to store any state related to the job.

timeout
number <int32>

Job timeout (in milliseconds)

Responses

Request samples

Content type
{
  • "subType": "inventory",
  • "type": "report",
  • "contentType": "string",
  • "internal": {
    },
  • "params": { },
  • "state": { },
  • "timeout": 0
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "job": {
    }
}

Delete (cancel) long-running job

Authorizations:
Pipe17KeyAuth
path Parameters
JobId
required
string

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Delete Multiple Jobs

Authorizations:
Pipe17KeyAuth
query Parameters
action
string (ListDeleteAction)
Default: "list"
Enum: "list" "soft"

Return the list of what to delete, or delete softly

count
integer <int32>
Default: 100

Max number of items to delete

jobId
Array of strings

Delete jobs by list of jobId

orgMode
Array of strings (OrganizationMode)
Items Enum: "sandbox" "production" "internal" "demo"

Delete jobs assigned these orgModes.

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Delete items created after this date-time

skip
integer <int32>
Default: 0

Number of items to skip

status
Array of strings (JobStatus)
Items Enum: "submitted" "processing" "completed" "canceled" "failed"

Delete items with given status

subType
Array of strings (JobSubType)
Items Enum: "inventory" "replenishment" "purchases" "transfers" "arrivals" "products" "organizations" "orders" "shipments" "fulfillments" "locations" "shipping_methods" "returns" "exceptions" "lookup_objects"

Delete items with given sub-type

type
Array of strings (JobType)
Items Enum: "report" "import" "prepare" "update" "delete" "export" "automation"

Delete items with given type

until
string <date-time>

Delete items created before this date-time

updatedSince
string <date-time>

Delete items updated after this date-time

updatedUntil
string <date-time>

Delete items updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "deleted": 0,
  • "filters": {
    },
  • "jobs": [
    ],
  • "pagination": {
    }
}

Fetch long-running job

Authorizations:
Pipe17KeyAuth
path Parameters
JobId
required
string

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "job": {
    }
}

Fetch long-running job results

Authorizations:
Pipe17KeyAuth
path Parameters
JobId
required
string

Responses

Response samples

Content type
No sample

List long-running jobs

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Max number of items to return

createdBy
Array of strings

Retrieve by list of job requester IDs

jobId
Array of strings

Retrieve by list of jobId

keys
string
Default: "jobId,createdBy,type,subType,params,status,progress,createdAt,updatedAt,orgKey"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Fetch items created after this date-time

skip
integer <int32>
Default: 0

Number of items to skip

status
Array of strings (JobStatus)
Items Enum: "submitted" "processing" "completed" "canceled" "failed"

Fetch items with given status

subType
Array of strings (JobSubType)
Items Enum: "inventory" "replenishment" "purchases" "transfers" "arrivals" "products" "organizations" "orders" "shipments" "fulfillments" "locations" "shipping_methods" "returns" "exceptions" "lookup_objects"

Fetch items with given sub-type

type
Array of strings (JobType)
Items Enum: "report" "import" "prepare" "update" "delete" "export" "automation"

Fetch items with given type

until
string <date-time>

Fetch items created before this date-time

updatedSince
string <date-time>

Fetch items updated after this date-time

updatedUntil
string <date-time>

Fetch items updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "jobs": [
    ],
  • "pagination": {
    }
}

Sync Jobs

Trigger the jobs sync

Authorizations:
Pipe17KeyAuth
path Parameters
JobId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update job

Authorizations:
Pipe17KeyAuth
path Parameters
JobId
required
string

Job ID

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
object (InternalInfo)

Internal info

progress
integer (JobProgress) [ 0 .. 100 ]

Job progress (0-100)

resultURL
string <uri>

Job result URL

state
object (JobState)

This is a free form object that can be used to store any state related to the job.

status
string (JobStatus)
Enum: "submitted" "processing" "completed" "canceled" "failed"

Job status

Responses

Request samples

Content type
{
  • "internal": {
    },
  • "progress": 100,
  • "resultURL": "http://example.com",
  • "state": { },
  • "status": "submitted"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "job": {
    }
}

Labels

Operations on Labels

Label Model

contentType
required
string
fileName
required
string
createdAt
string <date-time>

When the object was created within Pipe17

Array of objects (NameValue)

Custom Fields

object (InternalInfo)

Internal info

labelId
string

Label ID

labelType
string (LabelType)
Enum: "shippingLabel" "packingSlip"

Label type

orgKey
string

Organization this object belong to

shippingMethod
string
status
string
Enum: "new" "ready"

Label status

trackingNumber
string
updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "labelId": "string",
  • "status": "new",
  • "contentType": "string",
  • "fileName": "string",
  • "customFields": [
    ],
  • "internal": {
    },
  • "labelType": "shippingLabel",
  • "shippingMethod": "string",
  • "trackingNumber": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Label

Authorizations:
Pipe17KeyAuth
Request Body schema:
contentType
required
string
fileName
required
string
Array of objects (NameValue)

Custom Fields

object (InternalInfo)

Internal info

labelType
string (LabelType)
Enum: "shippingLabel" "packingSlip"

Label type

shippingMethod
string
trackingNumber
string

Responses

Request samples

Content type
{
  • "contentType": "string",
  • "fileName": "string",
  • "customFields": [
    ],
  • "internal": {
    },
  • "labelType": "shippingLabel",
  • "shippingMethod": "string",
  • "trackingNumber": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "label": {
    }
}

Delete Label

Authorizations:
Pipe17KeyAuth
path Parameters
LabelId
required
string

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Delete Labels

Authorizations:
Pipe17KeyAuth
query Parameters
action
string (ListDeleteAction)
Default: "list"
Enum: "list" "soft"

Return the list of what to delete, or delete softly

count
integer <int32>
Default: 100

Max number of items to delete

deleted
boolean

Delete soft deleted items

labelId
Array of strings

Delete items by list of labelId

orgMode
Array of strings (OrganizationMode)
Items Enum: "sandbox" "production" "internal" "demo"

Delete labels assigned these orgModes.

since
string <date-time>

Delete items created after this date-time

skip
integer <int32>
Default: 0

Number of items to skip

until
string <date-time>

Delete items created before this date-time

updatedSince
string <date-time>

Delete items updated after this date-time

updatedUntil
string <date-time>

Delete items updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "deleted": 0,
  • "filters": {
    },
  • "labels": [
    ],
  • "pagination": {
    }
}

Download Label Content

Authorizations:
Pipe17KeyAuth
path Parameters
LabelId
required
string

Responses

Response samples

Content type
application/json
{
  • "code": 404,
  • "success": false,
  • "conflict": { },
  • "errors": [
    ],
  • "message": "string"
}

Fetch Label

Authorizations:
Pipe17KeyAuth
path Parameters
LabelId
required
string

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "label": {
    }
}

List Labels

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Max number of items to return

deleted
boolean

Fetch soft deleted items

keys
string
Default: "labelId,fileName,contentType,createdAt,updatedAt,orgKey,status"

Return these top-level fields

labelId
Array of strings

Fetch items by list of labelId

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Fetch items created after this date-time

skip
integer <int32>
Default: 0

Number of items to skip

until
string <date-time>

Fetch items created before this date-time

updatedSince
string <date-time>

Fetch items updated after this date-time

updatedUntil
string <date-time>

Fetch items updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "labels": [
    ]
}

Sync Labels

Trigger the labels sync

Authorizations:
Pipe17KeyAuth
path Parameters
LabelId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Upload Label Content

Authorizations:
Pipe17KeyAuth
path Parameters
LabelId
required
string
Request Body schema: application/octet-stream
string <binary>

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "success": true
}

Locations

Operations about Locations

Location Model

required
object (LocationAddress)
name
required
string

Location Name

createdAt
string <date-time>

When the object was created within Pipe17

exceptions
Array of strings

References to exceptions related to the location

excludeFromTotals
boolean

Set to exclude location from calculating inventory totals

excludeFromTotalsFor
Array of strings

Requestors of inventory totals for whom the location should be excluded from calculating totals

excludeInventoryEvents
Array of strings

Set of events to be excluded from automated processing for this location

Array of objects (LocationExternalSystem)
fulfillmentIntegrationId
string

Set if this is a fulfillment location

integration
string

Reference to integration that created an item

object (InternalInfo)

Internal info

inventoryIntegrationId
string

Set if inventory source for this location is different from fulfillmentIntegrationId

inventoryNotTracked
boolean

Do not track inventory flag

locationId
string

Location ID

mergedWithLocationId
string

For merged locations, indicates which locationId current location is merged with

orgKey
string

Organization this object belong to

preserveBundles
boolean

Set if shipments to this location should have lineItems referring to bundles kept intact

routingPaused
boolean

Indicates the location is paused from routing

Array of objects (TimeRange)

Time intervals during which routing is paused

object (SourceDoc)

Vendor source document

status
string (LocationStatus)
Enum: "active" "inactive" "pending" "merged" "deleted"

Location status

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "exceptions": [
    ],
  • "integration": "string",
  • "locationId": "string",
  • "mergedWithLocationId": "string",
  • "address": {
    },
  • "name": "string",
  • "excludeFromTotals": true,
  • "excludeFromTotalsFor": [
    ],
  • "excludeInventoryEvents": [
    ],
  • "externalSystem": [
    ],
  • "fulfillmentIntegrationId": "string",
  • "internal": {
    },
  • "inventoryIntegrationId": "string",
  • "inventoryNotTracked": true,
  • "preserveBundles": true,
  • "routingPaused": true,
  • "routingPausedRanges": [
    ],
  • "sourceDoc": {
    },
  • "status": "active",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Location

Uniqueness constraints within organization:

  • location.name, location.integration
Authorizations:
Pipe17KeyAuth
Request Body schema:
required
object (LocationAddress)
name
required
string

Location Name

excludeFromTotals
boolean

Set to exclude location from calculating inventory totals

excludeFromTotalsFor
Array of strings

Requestors of inventory totals for whom the location should be excluded from calculating totals

excludeInventoryEvents
Array of strings

Set of events to be excluded from automated processing for this location

Array of objects (LocationExternalSystem)
fulfillmentIntegrationId
string

Set if this is a fulfillment location

object (InternalInfo)

Internal info

inventoryIntegrationId
string

Set if inventory source for this location is different from fulfillmentIntegrationId

inventoryNotTracked
boolean

Do not track inventory flag

preserveBundles
boolean

Set if shipments to this location should have lineItems referring to bundles kept intact

routingPaused
boolean

Indicates the location is paused from routing

Array of objects (TimeRange)

Time intervals during which routing is paused

object (SourceDoc)

Vendor source document

status
string (LocationStatus)
Enum: "active" "inactive" "pending" "merged" "deleted"

Location status

Responses

Request samples

Content type
{
  • "address": {
    },
  • "name": "string",
  • "excludeFromTotals": true,
  • "excludeFromTotalsFor": [
    ],
  • "excludeInventoryEvents": [
    ],
  • "externalSystem": [
    ],
  • "fulfillmentIntegrationId": "string",
  • "internal": {
    },
  • "inventoryIntegrationId": "string",
  • "inventoryNotTracked": true,
  • "preserveBundles": true,
  • "routingPaused": true,
  • "routingPausedRanges": [
    ],
  • "sourceDoc": {
    },
  • "status": "active"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "location": {
    }
}

Delete Location

Authorizations:
Pipe17KeyAuth
path Parameters
LocationId
required
string

Location ID to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Delete Multiple Locations

Authorizations:
Pipe17KeyAuth
query Parameters
action
string (ListDeleteAction)
Default: "list"
Enum: "list" "soft"

Return the list of what to delete, or delete softly

count
integer <int32>
Default: 100

Delete at most this many locations

deleted
boolean

Delete soft deleted locations

excludeFromTotals
boolean

Delete locations excluded from calculating inventory totals

integration
Array of strings

Delete locations of these integrations

locationId
Array of strings

Delete locations by list of locationId

orgMode
Array of strings (OrganizationMode)
Items Enum: "sandbox" "production" "internal" "demo"

Delete locations assigned these orgModes.

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Delete locations created after this date-time

skip
integer <int32>
Default: 0

Skip this many locations

status
Array of strings (LocationStatus)
Items Enum: "active" "inactive" "pending" "merged" "deleted"

Delete by list of location statuses

until
string <date-time>

Delete locations created before this date-time

updatedSince
string <date-time>

Delete locations updated after this date-time

updatedUntil
string <date-time>

Delete locations updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "deleted": 0,
  • "filters": {
    },
  • "locations": [
    ],
  • "pagination": {
    }
}

Fetch Location

Authorizations:
Pipe17KeyAuth
path Parameters
LocationId
required
string

Location ID to fetch

query Parameters
sourceDocVersion
number

Fetch specific vendor source doc version if available

withSourceDoc
boolean

Include vendor source doc if available

withSourceDocVersions
boolean

Include available vendor source doc versions

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "location": {
    }
}

List Locations

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Return at most this many locations

deleted
boolean

Retrieve soft deleted locations

email
string

Retrieve locations by email (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

exceptionCategoryId
Array of strings

Locations by list of categories of the location related exceptions

exceptionType
Array of strings

Locations by list of types of the location related exceptions ({exceptionType} | {entityType}_{exceptionType})

excludeFromTotals
boolean

Locations excluded from calculating inventory totals

extIntegrationId
Array of strings

Retrieve locations by list of external integration ids

extLocationId
Array of strings

Retrieve locations by list of external location ids

hasSourceDoc
boolean

Locations containing a source document

integration
Array of strings
inventoryNotTracked
boolean

Retrieve locations by inventoryNotTracked value (default - any)

keys
string
Default: "inventoryNotTracked,locationId,status,name,address,excludeFromTotals,createdAt,updatedAt,orgKey"

Return these top-level fields

locationId
Array of strings

Retrieve by list of locationId

mergedWithLocationId
Array of strings

Retrieve locations by list of mergedWithLocationId

name
string

Retrieve locations by name (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

phone
string

Retrieve locations by phone (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

since
string <date-time>

Locations created after this date-time

skip
integer <int32>
Default: 0

Skip this many locations

status
Array of strings (LocationStatus)
Items Enum: "active" "inactive" "pending" "merged" "deleted"

Retrieve by list of location statuses

until
string <date-time>

Locations created before this date-time

updatedSince
string <date-time>

Locations updated after this date-time

updatedUntil
string <date-time>

Locations updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "locations": [
    ],
  • "pagination": {
    }
}

Sync Locations

Trigger the locations sync

Authorizations:
Pipe17KeyAuth
path Parameters
LocationId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Location

Uniqueness constraints within organization:

  • location.name, location.integration
Authorizations:
Pipe17KeyAuth
path Parameters
LocationId
required
string

Location ID to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
object (LocationUpdateAddress)
excludeFromTotals
boolean

Set to exclude location from calculating inventory totals

excludeFromTotalsFor
Array of strings or null

Requestors of inventory totals for whom the location should be excluded from calculating totals

excludeInventoryEvents
Array of strings

Set of events to be excluded from automated processing for this location

Array of objects (LocationExternalSystem)
fulfillmentIntegrationId
string or null

Set if this is a fulfillment location

object (InternalInfo)

Internal info

inventoryIntegrationId
string or null

Set if inventory source for this location is different from fulfillmentIntegrationId

inventoryNotTracked
boolean or null

Do not track inventory flag

mergedWithLocationId
string

For merged locations, indicates which locationId current location is merged with

name
string

Location Name

preserveBundles
boolean

Set if shipments to this location should have lineItems referring to bundles kept intact

routingPaused
boolean or null

Indicates the location is paused from routing

Array of objects or null (TimeRange)

Time intervals during which routing is paused

object (SourceDoc)

Vendor source document

status
string (LocationStatus)
Enum: "active" "inactive" "pending" "merged" "deleted"

Location status

Responses

Request samples

Content type
{
  • "address": {
    },
  • "excludeFromTotals": true,
  • "excludeFromTotalsFor": [
    ],
  • "excludeInventoryEvents": [
    ],
  • "externalSystem": [
    ],
  • "fulfillmentIntegrationId": "string",
  • "internal": {
    },
  • "inventoryIntegrationId": "string",
  • "inventoryNotTracked": true,
  • "mergedWithLocationId": "string",
  • "name": "string",
  • "preserveBundles": true,
  • "routingPaused": true,
  • "routingPausedRanges": [
    ],
  • "sourceDoc": {
    },
  • "status": "active"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "location": {
    }
}

Order Statement Transactions

Operations about Order Statement Transactions

Order Statement Transaction Model

extTransactionId
required
string

External transaction ID

statementId
required
string

Statement ID

transactionType
required
string (TransactionType)
Value: "orders"

Transaction type

createdAt
string <date-time>

When the object was created within Pipe17

Array of objects (NameValue)

Custom Fields

extReferenceId
string

External ID

extStatementId
string

External statement ID

integration
string

Integration associated with transaction

object (InternalInfo)

Internal info

orgKey
string

Organization this object belong to

sku
string

SKU

object (SourceDoc)

Vendor source document

status
string
Enum: "new" "draft" "pending" "reported"

Transaction status

Array of objects (Fee)
transactionId
string

Transaction ID

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "integration": "string",
  • "status": "new",
  • "transactionId": "string",
  • "extTransactionId": "string",
  • "statementId": "string",
  • "transactionType": "orders",
  • "customFields": [
    ],
  • "extReferenceId": "string",
  • "extStatementId": "string",
  • "internal": {
    },
  • "sku": "string",
  • "sourceDoc": {
    },
  • "transactionFees": [
    ],
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Transactions

Authorizations:
Pipe17KeyAuth
Request Body schema:
Array (<= 10 items)
extTransactionId
required
string

External transaction ID

statementId
required
string

Statement ID

transactionType
required
string (TransactionType)
Value: "orders"

Transaction type

Array of objects (NameValue)

Custom Fields

extReferenceId
string

External ID

extStatementId
string

External statement ID

object (InternalInfo)

Internal info

sku
string

SKU

object (SourceDoc)

Vendor source document

status
string (TransactionStatus)
Enum: "new" "draft" "pending" "reported"

Transaction status

Array of objects (Fee)

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "transactions": [
    ]
}

Delete Transaction

Authorizations:
Pipe17KeyAuth
path Parameters
TransactionId
required
string

Transaction Id to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Transaction

Authorizations:
Pipe17KeyAuth
path Parameters
TransactionId
required
string

Id or ext:{extTransactionId} of transaction to fetch

query Parameters
sourceDocVersion
number

Fetch specific source doc version if available

withSourceDoc
boolean

Include source doc if available

withSourceDocVersions
boolean

Include available source doc versions

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "transaction": {
    }
}

List Transactions

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Return at most this many transactions

deleted
boolean

Retrieve only soft deleted transactions

extReferenceId
Array of strings

Retrieve transactions by extReferenceId list

extStatementId
Array of strings

Retrieve transactions by extStatementId list

extTransactionId
Array of strings

Retrieve transactions by extTransactionId list

hasSourceDoc
boolean

Retrieve transactions containing a source document

integration
Array of strings

Retrieve transactions by integration list

keys
string
Default: "transactionId,extReferenceId,statementId,extStatementId,extTransactionId,integration,sku,transactionType,transactionFees,status,createdAt,updatedAt,orgKey"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Transactions created after this date-time

skip
integer <int32>
Default: 0

Skip this many transactions

sku
Array of strings

Retrieve transactions by SKU list

statementId
Array of strings

Retrieve transactions by statementId list

status
Array of strings (TransactionStatus)
Items Enum: "new" "draft" "pending" "reported"

Retrieve transactions by status list

transactionId
Array of strings

Retrieve transactions by transactionId list

transactionType
Array of strings

Retrieve transactions by transactionType list

until
string <date-time>

Transactions created before this date-time

updatedSince
string <date-time>

Transactions updated after this date-time

updatedUntil
string <date-time>

Transactions updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "pagination": {
    },
  • "transactions": [
    ]
}

Sync Statement Transactions

Trigger the statement transactions sync

Authorizations:
Pipe17KeyAuth
path Parameters
TransactionId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Transaction

Authorizations:
Pipe17KeyAuth
path Parameters
TransactionId
required
string

Transaction Id to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
Array of objects or null (NameValue)

Custom Fields

object (InternalInfo)

Internal info

object (SourceDoc)

Vendor source document

status
string (TransactionStatus)
Enum: "new" "draft" "pending" "reported"

Transaction status

Array of objects (Fee)

Responses

Request samples

Content type
{
  • "customFields": [
    ],
  • "internal": {
    },
  • "sourceDoc": {
    },
  • "status": "new",
  • "transactionFees": [
    ]
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "transaction": {
    }
}

Order Statements

Operations about Order Statements

Order Statement Model

extStatementId
required
string

External statement ID

extStatementStartDate
required
string <date-time>

External statement start-date

createdAt
string <date-time>

When the object was created within Pipe17

currency
string

Currency

Array of objects (NameValue)

Custom Fields

depositTotal
number

Deposit total

extStatementApiId
string

External statement Api ID

extStatementDepositDate
string <date-time>

External statement deposit-date

extStatementEndDate
string <date-time>

External statement end-date

integration
string

Integration associated with statement

object (InternalInfo)

Internal info

orgKey
string

Organization this object belong to

object (SourceDoc)

Vendor source document

statementId
string

Statement ID

statementTotal
number

Statement total

status
string
Enum: "new" "draft" "pending" "paid" "reported"

Statement status

Array of objects (Fee)
Array of objects (Fee)

Fees totals by all registered transactions

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "integration": "string",
  • "statementId": "string",
  • "status": "new",
  • "transactionFeesTotals": [
    ],
  • "extStatementId": "string",
  • "extStatementStartDate": "2019-08-24T14:15:22Z",
  • "currency": "string",
  • "customFields": [
    ],
  • "depositTotal": 0,
  • "extStatementApiId": "string",
  • "extStatementDepositDate": "2019-08-24T14:15:22Z",
  • "extStatementEndDate": "2019-08-24T14:15:22Z",
  • "internal": {
    },
  • "sourceDoc": {
    },
  • "statementTotal": 0,
  • "transactionFees": [
    ],
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Statements

Authorizations:
Pipe17KeyAuth
Request Body schema:
Array (<= 10 items)
extStatementId
required
string

External statement ID

extStatementStartDate
required
string <date-time>

External statement start-date

currency
string

Currency

Array of objects (NameValue)

Custom Fields

depositTotal
number

Deposit total

extStatementApiId
string

External statement Api ID

extStatementDepositDate
string <date-time>

External statement deposit-date

extStatementEndDate
string <date-time>

External statement end-date

object (InternalInfo)

Internal info

object (SourceDoc)

Vendor source document

statementTotal
number

Statement total

status
string (StatementStatus)
Enum: "new" "draft" "pending" "paid" "reported"

Statement status

Array of objects (Fee)

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "statements": [
    ]
}

Delete Statement

Authorizations:
Pipe17KeyAuth
path Parameters
StatementId
required
string

Statement Id to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Statement

Authorizations:
Pipe17KeyAuth
path Parameters
StatementId
required
string

Id or ext:{extStatementId} of statement to fetch

query Parameters
sourceDocVersion
number

Fetch specific source doc version if available

withFeesTotals
boolean

Add the fees totals in the response

withSourceDoc
boolean

Include source doc if available

withSourceDocVersions
boolean

Include available source doc versions

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "statement": {
    }
}

List Statements

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Return at most this many statements

deleted
boolean

Retrieve only soft deleted statements

depositSince
string <date-time>

Statements where (extStatementDepositDate >= depositSince)

depositUntil
string <date-time>

Statements where (extStatementDepositDate < depositUntil)

endPeriodSince
string <date-time>

Statements where (extStatementEndDate >= endPeriodSince)

endPeriodUntil
string <date-time>

Statements where (extStatementEndDate < endPeriodUntil)

extStatementApiId
Array of strings

Retrieve statements by extStatementApiId list

extStatementId
Array of strings

Retrieve statements by extStatementId list

hasSourceDoc
boolean

Retrieve statements containing a source document

integration
Array of strings

Retrieve statements by integration list

keys
string
Default: "statementId,extStatementId,extStatementApiId,integration,extStatementStartDate,extStatementEndDate,extStatementDepositDate,depositTotal,transactionFees,statementTotal,currency,status,createdAt,updatedAt,orgKey"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Statements created after this date-time

skip
integer <int32>
Default: 0

Skip this many statements

startPeriodSince
string <date-time>

Statements where (extStatementStartDate >= startPeriodSince)

startPeriodUntil
string <date-time>

Statements where (extStatementStartDate < startPeriodUntil)

statementId
Array of strings

Retrieve statements by statementId list

status
Array of strings (StatementStatus)
Items Enum: "new" "draft" "pending" "paid" "reported"

Retrieve statements by status list

until
string <date-time>

Statements created before this date-time

updatedSince
string <date-time>

Statements updated after this date-time

updatedUntil
string <date-time>

Statements updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "pagination": {
    },
  • "statements": [
    ]
}

Sync Statements

Trigger the statements sync

Authorizations:
Pipe17KeyAuth
path Parameters
StatementId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Statement

Authorizations:
Pipe17KeyAuth
path Parameters
StatementId
required
string

Statement Id to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
currency
string

Currency

Array of objects or null (NameValue)

Custom Fields

depositTotal
number

Deposit total

extStatementDepositDate
string <date-time>

External statement deposit-date

extStatementEndDate
string <date-time>

External statement end-date

extStatementStartDate
string <date-time>

External statement start-date

object (InternalInfo)

Internal info

object (SourceDoc)

Vendor source document

statementTotal
number

Statement total

status
string (StatementStatus)
Enum: "new" "draft" "pending" "paid" "reported"

Statement status

Array of objects (Fee)

Responses

Request samples

Content type
{
  • "currency": "string",
  • "customFields": [
    ],
  • "depositTotal": 0,
  • "extStatementDepositDate": "2019-08-24T14:15:22Z",
  • "extStatementEndDate": "2019-08-24T14:15:22Z",
  • "extStatementStartDate": "2019-08-24T14:15:22Z",
  • "internal": {
    },
  • "sourceDoc": {
    },
  • "statementTotal": 0,
  • "status": "new",
  • "transactionFees": [
    ]
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "statement": {
    }
}

Orders

Operations about Orders

Order Model

extOrderId
required
string

External Order ID

Array of objects (AdditionalCharge)

Additional charges

autoEngUpdateStatus
string (AutoEngUpdateStatus)
Enum: "pending" "updated" "none"

A status that indicates whether or not the automation engine may update the entity sometime in the future. Only set internally. Useful for services such as the order routing engine where the user intended order state is critical before action. Used for orders and shipments.

Status definitions:

  • pending: the automation engine will make an update to this entity in the future.
  • updated: the automation engine has successfully made an update to this entity.
  • none: No status to set because the org did not have an enabled automation at the time of create/update.
autoEngUpdateStatusUpdatedAt
string <date-time> (AutoEngUpdateStatusUpdatedAt)

When the autoEngUpdateStatus was last updated

object (Address)
createdAt
string <date-time>

When the object was created within Pipe17

currency
string

Order currency code

object (OrderCustomer)
customerPONumber
string or null
Array of objects (NameValue)

Custom Fields

disableShipmentsReuse
boolean

Hint to whether shipmentId should be re-used, or not

Array of objects (Discount)

Discounts

exceptions
Array of strings

References to exceptions related to the order

expectedDeliveryDate
string <date-time>

First Priority to be respected

extOrderApiId
string

External System Order API ID

extOrderCreatedAt
string <date-time>

When the order was created at source

extOrderUpdatedAt
string <date-time>

When the order was updated at source

extOrderUrl
string

Order Url in External System

fulfillmentStatus
string

status of the fulfillment

giftNote
string

Order Gift note

holdUntil
string <date-time>
incoterms
string

International Commercial Terms

integration
string

Reference to integration that created an item

object (InternalInfo)

Internal info

isMultiAddress
boolean

Indicates the order is a multi address destination order (default - false)

isMultiDestination
boolean

Multi-destination order indicator

lastRerunRoutingTrigger
string (LastRerunRoutingTrigger)
Enum: "manual" "auto"

Indicates if the order was rerun manually by a user action or automatically.

lastRoutedAt
string <date-time>

When the order was last routed.

Array of objects (OrderLineItem)
locationId
string

Id of location defined in organization. Used as item origin for shipment.

orderDiscount
number <float>

Order Discount

orderId
string

Auto Generated

orderNote
string

Order Notes

orderSource
string

The original order platform, walmart, etsy, etc

orderSourceType
string (OrderType)
Enum: "online" "pos" "wholesale" "edi" "other" "b2b"

Order Type (online, pos, etc)

orderTax
number <float>

Order Tax

orgKey
string

Organization this object belong to

Array of objects (Payment)

Payments

paymentStatus
string

status of the payment

object (OrderPaymentTerms)

order payment terms

Array of objects (OrderRefund)

Additional charges

requireShippingLabels
boolean

Indicates if fetching of shipping labels is required

respectLocationId
boolean

Use locationId if defined on order level or lineItems level as valid item origin for shipment (pre-route).

routingStatus
string (RoutingStatus)
Enum: "disabled" "pending" "ready" "acknowledged" "failed" "excluded" "pendingInventory"

Routing Status:

  • pending - order should be be processed by Order Routing engine once its status is readyForFulfillment
  • ready - order is ready to be processed by Order Routing engine. This status is applied
    • when order status transitions to readyForFulfillment and current routing status is pending
    • when routing status is acknowledged or failed and significant order properties are changed
  • pendingInventory - order should be routed by Order Routing engine once inventory is available
  • acknowledged - order is acknowledged by Order Routing engine and will not be processed by Order routing
  • disabled - order routing is disabled
  • failed - order routing failed and will be retried by Order Routing engine
shipAfterDate
string <date-time>

Ship After Date

shipByDate
string <date-time>

Ship By Date

shipCancelByDate
string <date-time>

Ship Cancel By Date

object (Address)
shippingCarrier
string

Required with ShippingClass, 2nd Priority

shippingClass
string

Required with ShippingCarrier, 2nd Priority

shippingCode
string

1st Priority

Array of objects (Destination)
shippingNote
string

Shipping Notes

shippingPrice
number <float>

Shipping price

object (SourceDoc)

Vendor source document

status
string
Enum: "draft" "new" "onHold" "toBeValidated" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "partialFulfillment" "fulfilled" "inTransit" "partialReceived" "received" "canceled" "returned" "refunded" "archived" "closed"

Order Status

subTotalPrice
number <float>

Sub Total Price

tags
Array of strings (EntityTags)

Tags assigned to entity

timestamp
string <date-time>

General Purpose Time Stamp

totalPrice
number <float>

Total Price

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "autoEngUpdateStatus": "pending",
  • "autoEngUpdateStatusUpdatedAt": "2019-08-24T14:15:22Z",
  • "exceptions": [
    ],
  • "integration": "string",
  • "isMultiDestination": true,
  • "orderId": "string",
  • "status": "draft",
  • "extOrderId": "string",
  • "additionalCharges": [
    ],
  • "billingAddress": {
    },
  • "currency": "string",
  • "customFields": [
    ],
  • "customer": {
    },
  • "customerPONumber": "string",
  • "disableShipmentsReuse": true,
  • "discounts": [
    ],
  • "expectedDeliveryDate": "2019-08-24T14:15:22Z",
  • "extOrderApiId": "string",
  • "extOrderCreatedAt": "2019-08-24T14:15:22Z",
  • "extOrderUpdatedAt": "2019-08-24T14:15:22Z",
  • "extOrderUrl": "string",
  • "fulfillmentStatus": "string",
  • "giftNote": "string",
  • "holdUntil": "2019-08-24T14:15:22Z",
  • "incoterms": "string",
  • "internal": {
    },
  • "isMultiAddress": true,
  • "lastRerunRoutingTrigger": "manual",
  • "lastRoutedAt": "2019-08-24T14:15:22Z",
  • "lineItems": [
    ],
  • "locationId": "string",
  • "orderDiscount": 0,
  • "orderNote": "string",
  • "orderSource": "string",
  • "orderSourceType": "online",
  • "orderTax": 0,
  • "paymentStatus": "string",
  • "paymentTerms": {
    },
  • "payments": [
    ],
  • "refunds": [
    ],
  • "requireShippingLabels": true,
  • "respectLocationId": true,
  • "routingStatus": "disabled",
  • "shipAfterDate": "2019-08-24T14:15:22Z",
  • "shipByDate": "2019-08-24T14:15:22Z",
  • "shipCancelByDate": "2019-08-24T14:15:22Z",
  • "shippingAddress": {
    },
  • "shippingCarrier": "string",
  • "shippingClass": "string",
  • "shippingCode": "string",
  • "shippingDestinations": [
    ],
  • "shippingNote": "string",
  • "shippingPrice": 0,
  • "sourceDoc": {
    },
  • "subTotalPrice": 0,
  • "tags": [
    ],
  • "timestamp": "2019-08-24T14:15:22Z",
  • "totalPrice": 0,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Orders

Uniqueness constraints within organization:

  • order.extOrderId, order.orderSource
  • order.extOrderApiId (when defined)
Authorizations:
Pipe17KeyAuth
query Parameters
withTransform
boolean

Enable order transformation engine for this request

Request Body schema:
Array (<= 10 items)
extOrderId
required
string

External Order ID

Array of objects (AdditionalCharge)

Additional charges

object (Address)
currency
string

Order currency code

object (OrderCustomer)
customerPONumber
string or null
Array of objects (NameValue)

Custom Fields

disableShipmentsReuse
boolean

Hint to whether shipmentId should be re-used, or not

Array of objects (Discount)

Discounts

expectedDeliveryDate
string <date-time>

First Priority to be respected

extOrderApiId
string

External System Order API ID

extOrderCreatedAt
string <date-time>

When the order was created at source

extOrderUpdatedAt
string <date-time>

When the order was updated at source

extOrderUrl
string

Order Url in External System

fulfillmentStatus
string

status of the fulfillment

giftNote
string

Order Gift note

holdUntil
string <date-time>
incoterms
string

International Commercial Terms

object (InternalInfo)

Internal info

isMultiAddress
boolean

Indicates the order is a multi address destination order (default - false)

lastRerunRoutingTrigger
string (LastRerunRoutingTrigger)
Enum: "manual" "auto"

Indicates if the order was rerun manually by a user action or automatically.

lastRoutedAt
string <date-time>

When the order was last routed.

Array of objects (OrderLineItem)
locationId
string

Id of location defined in organization. Used as item origin for shipment.

orderDiscount
number <float>

Order Discount

orderNote
string

Order Notes

orderSource
string

The original order platform, walmart, etsy, etc

orderSourceType
string (OrderType)
Enum: "online" "pos" "wholesale" "edi" "other" "b2b"

Order Type (online, pos, etc)

orderTax
number <float>

Order Tax

Array of objects (Payment)

Payments

paymentStatus
string

status of the payment

object (OrderPaymentTerms)

order payment terms

Array of objects (OrderRefund)

Additional charges

requireShippingLabels
boolean

Indicates if fetching of shipping labels is required

respectLocationId
boolean

Use locationId if defined on order level or lineItems level as valid item origin for shipment (pre-route).

routingStatus
string (RoutingStatus)
Enum: "disabled" "pending" "ready" "acknowledged" "failed" "excluded" "pendingInventory"

Routing Status:

  • pending - order should be be processed by Order Routing engine once its status is readyForFulfillment
  • ready - order is ready to be processed by Order Routing engine. This status is applied
    • when order status transitions to readyForFulfillment and current routing status is pending
    • when routing status is acknowledged or failed and significant order properties are changed
  • pendingInventory - order should be routed by Order Routing engine once inventory is available
  • acknowledged - order is acknowledged by Order Routing engine and will not be processed by Order routing
  • disabled - order routing is disabled
  • failed - order routing failed and will be retried by Order Routing engine
shipAfterDate
string <date-time>

Ship After Date

shipByDate
string <date-time>

Ship By Date

shipCancelByDate
string <date-time>

Ship Cancel By Date

object (Address)
shippingCarrier
string

Required with ShippingClass, 2nd Priority

shippingClass
string

Required with ShippingCarrier, 2nd Priority

shippingCode
string

1st Priority

Array of objects (Destination)
shippingNote
string

Shipping Notes

shippingPrice
number <float>

Shipping price

object (SourceDoc)

Vendor source document

status
string (OrderStatus)
Enum: "draft" "new" "onHold" "toBeValidated" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "partialFulfillment" "fulfilled" "inTransit" "partialReceived" "received" "canceled" "returned" "refunded" "archived" "closed"

Order Status

subTotalPrice
number <float>

Sub Total Price

tags
Array of strings (EntityTags)

Tags assigned to entity

timestamp
string <date-time>

General Purpose Time Stamp

totalPrice
number <float>

Total Price

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "orders": [
    ]
}

Delete Multiple Orders

Authorizations:
Pipe17KeyAuth
query Parameters
action
string (ListDeleteAction)
Default: "list"
Enum: "list" "soft"

Return the list of what to delete, or delete softly

count
integer <int32>
Default: 100

Delete at most this many orders

deleted
boolean

Delete soft deleted orders

extOrderId
Array of strings

Delete orders by list of extOrderId

integration
Array of strings

Delete orders of these integrations

orderId
Array of strings

Delete orders by list of orderId

orderSource
Array of strings

Delete orders by list of order sources

orderSourceType
Array of strings (OrderType)
Items Enum: "online" "pos" "wholesale" "edi" "other" "b2b"

Delete orders by list of order types

orgMode
Array of strings (OrganizationMode)
Items Enum: "sandbox" "production" "internal" "demo"

Delete orders assigned these orgModes.

pagination
string
Value: "disabled"

Exclude pagination info from the response

routingStatus
Array of strings (RoutingStatus)
Items Enum: "disabled" "pending" "ready" "acknowledged" "failed" "excluded" "pendingInventory"

Delete orders by list of routing statuses

since
string <date-time>

Delete orders created after this date-time

skip
integer <int32>
Default: 0

Skip this many orders

status
Array of strings (OrderStatus)
Items Enum: "draft" "new" "onHold" "toBeValidated" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "partialFulfillment" "fulfilled" "inTransit" "partialReceived" "received" "canceled" "returned" "refunded" "archived" "closed"

Delete orders by list of statuses

until
string <date-time>

Delete orders created before this date-time

updatedSince
string <date-time>

Delete orders updated after this date-time

updatedUntil
string <date-time>

Delete orders updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "deleted": 0,
  • "filters": {
    },
  • "orders": [
    ],
  • "pagination": {
    }
}

Delete Order

Authorizations:
Pipe17KeyAuth
path Parameters
OrderId
required
string

Id, ext:{extOrderId}, or api:{extOrderApiId} of order to delete

query Parameters
nested
boolean

Delete nested entities

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Order

Authorizations:
Pipe17KeyAuth
path Parameters
OrderId
required
string

Id, ext:{extOrderId}, or api:{extOrderApiId} of order to fetch

query Parameters
sourceDocVersion
number

Fetch specific vendor source doc version if available

withSourceDoc
boolean

Include vendor source doc if available

withSourceDocVersions
boolean

Include available vendor source doc versions

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "order": {
    }
}

List Orders

Authorizations:
Pipe17KeyAuth
query Parameters
autoEngUpdateStatus
Array of strings (AutoEngUpdateStatus)
Items Enum: "pending" "updated" "none"
autoEngUpdateStatusUpdatedSince
string <date-time>

Fetch all orders with autoEngUpdateStatus updated after this date-time

autoEngUpdateStatusUpdatedUntil
string <date-time>

Fetch all orders with autoEngUpdateStatus updated before this date-time

count
integer <int32>
Default: 100

Return at most this many orders

deleted
boolean

Fetch soft deleted orders

email
string

Fetch orders by recipient email (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

emailAddr
Array of strings

Retrieve orders by list of billing/shippingAddress.email (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

exceptionCategoryId
Array of strings

Fetch orders by list of categories of the order related exceptions

exceptionType
Array of strings

Fetch orders by list of types of the order related exceptions ({exceptionType} | {entityType}_{exceptionType})

extOrderId
Array of strings

Fetch orders by list of extOrderId

hasSourceDoc
boolean

Orders containing a source document

holdUntilSince
string <date-time>

Fetch all orders with holdUntil after or at this date-time. Rounded down to the nearest minute

holdUntilUntil
string <date-time>

Fetch all orders with holdUntil before or at this date-time. Rounded down to the nearest minute

integration
Array of strings

Fetch orders by list of integrationId

keys
string
Default: "orderId,extOrderId,email,status,shipByDate,expectedDeliveryDate,tags,createdAt,updatedAt,orgKey"

Return these top-level fields

lastRerunRoutingTrigger
Array of strings (LastRerunRoutingTrigger)
Items Enum: "manual" "auto"

Fetch orders by list of rerun routing triggers

locationId
Array of strings

Fetch orders by list of locationId

order
string
Default: "createdAt"

Sort by these top-level fields

orderId
Array of strings

Fetch orders by list of orderId

orderSource
Array of strings

Fetch orders by list of order sources

orderSourceType
Array of strings (OrderType)
Items Enum: "online" "pos" "wholesale" "edi" "other" "b2b"

Fetch orders by list of types

pagination
string
Value: "disabled"

Exclude pagination info from the response

requireShippingLabels
boolean

Filter orders by shipping labels requirement

routingStatus
Array of strings (RoutingStatus)
Items Enum: "disabled" "pending" "ready" "acknowledged" "failed" "excluded" "pendingInventory"

Orders by list of routing statuses

since
string <date-time>

Fetch all orders created after this date-time

skip
integer <int32>
Default: 0

Skip this many orders

status
Array of strings (OrderStatus)
Items Enum: "draft" "new" "onHold" "toBeValidated" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "partialFulfillment" "fulfilled" "inTransit" "partialReceived" "received" "canceled" "returned" "refunded" "archived" "closed"

Fetch orders by list of statuses

timestamp
boolean

if set to true use timestamp instead of create time

until
string <date-time>

Fetch all orders created before this date-time

updatedSince
string <date-time>

Fetch all orders updated after this date-time

updatedUntil
string <date-time>

Fetch all orders updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "orders": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Sync Orders

Trigger the orders sync

Authorizations:
Pipe17KeyAuth
path Parameters
OrderId
required
Array of strings
Request Body schema:
syncAE
boolean

Reset autoEngUpdateStatus

Responses

Request samples

Content type
{
  • "syncAE": true
}

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Order

Uniqueness constraints within organization:

  • order.extOrderId, order.orderSource
  • order.extOrderApiId (when defined)
Authorizations:
Pipe17KeyAuth
path Parameters
OrderId
required
string

Id, ext:{extOrderId}, or api:{extOrderApiId} of order to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

withTransform
boolean

Enable order transformation engine for this request

Request Body schema:
Array of objects or null (AdditionalCharge)

Additional charges

autoEngUpdateStatus
string (AutoEngUpdateStatus)
Enum: "pending" "updated" "none"

A status that indicates whether or not the automation engine may update the entity sometime in the future. Only set internally. Useful for services such as the order routing engine where the user intended order state is critical before action. Used for orders and shipments.

Status definitions:

  • pending: the automation engine will make an update to this entity in the future.
  • updated: the automation engine has successfully made an update to this entity.
  • none: No status to set because the org did not have an enabled automation at the time of create/update.
object (AddressUpdateData)
currency
string

Order currency code

object (OrderCustomer)
customerPONumber
string or null
Array of objects (NameValue)

Custom Fields

disableShipmentsReuse
boolean or null

Hint to whether shipmentId should be re-used, or not

Array of objects or null (Discount)

Discounts

expectedDeliveryDate
string or null <date-time>

First Priority to be respected

extOrderApiId
string or null

External System Order API ID

extOrderCreatedAt
string or null <date-time>

When the order was created at source

extOrderId
string

External Order ID

extOrderUpdatedAt
string or null <date-time>

When the order was updated at source

extOrderUrl
string

Order Url in External System

fulfillmentStatus
string or null

status of the fulfillment

giftNote
string or null

Order Gift note

holdUntil
string or null <date-time>
object (InternalInfo)

Internal info

isMultiAddress
boolean or null

Indicates the order is a multi address destination order (default - false)

lastRerunRoutingTrigger
string (LastRerunRoutingTrigger)
Enum: "manual" "auto"

Indicates if the order was rerun manually by a user action or automatically.

lastRoutedAt
string <date-time>

When the order was last routed.

Array of objects (OrderUpdateLineItem)
locationId
string or null

Id of location defined in organization. Used as item origin for shipment.

orderDiscount
number or null <float>

Order Discount

orderNote
string or null

Order Notes

orderSource
string or null

The original order platform, walmart, etsy, etc

orderSourceType
string (OrderType)
Enum: "online" "pos" "wholesale" "edi" "other" "b2b"

Order Type (online, pos, etc)

orderTax
number or null <float>

Order Tax

Array of objects or null (Payment)

Payments

paymentStatus
string or null

status of the payment

object (OrderPaymentTerms)

order payment terms

Array of objects or null (OrderRefund)

Order refunds

requireShippingLabels
boolean or null

Indicates if fetching of shipping labels is required

respectLocationId
boolean or null

Use locationId if defined on order level or lineItems level as valid item origin for shipment (pre-route).

routingStatus
string (RoutingStatus)
Enum: "disabled" "pending" "ready" "acknowledged" "failed" "excluded" "pendingInventory"

Routing Status:

  • pending - order should be be processed by Order Routing engine once its status is readyForFulfillment
  • ready - order is ready to be processed by Order Routing engine. This status is applied
    • when order status transitions to readyForFulfillment and current routing status is pending
    • when routing status is acknowledged or failed and significant order properties are changed
  • pendingInventory - order should be routed by Order Routing engine once inventory is available
  • acknowledged - order is acknowledged by Order Routing engine and will not be processed by Order routing
  • disabled - order routing is disabled
  • failed - order routing failed and will be retried by Order Routing engine
shipAfterDate
string or null <date-time>

Ship After Date

shipByDate
string or null <date-time>

Ship By Date

shipCancelByDate
string or null <date-time>

Ship Cancel By Date

object (AddressUpdateData)
shippingCarrier
string or null

Required with ShippingClass, 2nd Priority

shippingClass
string or null

Required with ShippingCarrier, 2nd Priority

shippingCode
string or null

1st Priority

Array of objects (Destination)
shippingNote
string or null

Shipping Notes

shippingPrice
number or null <float>
object (SourceDoc)

Vendor source document

status
string (OrderStatus)
Enum: "draft" "new" "onHold" "toBeValidated" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "partialFulfillment" "fulfilled" "inTransit" "partialReceived" "received" "canceled" "returned" "refunded" "archived" "closed"

Order Status

subTotalPrice
number or null <float>

Sub Total Price

tags
Array of strings (EntityTags)

Tags assigned to entity

timestamp
string or null <date-time>

General Purpose Time Stamp

totalPrice
number or null <float>

Total Price

Responses

Request samples

Content type
{
  • "additionalCharges": [
    ],
  • "autoEngUpdateStatus": "pending",
  • "billingAddress": {
    },
  • "currency": "string",
  • "customFields": [
    ],
  • "customer": {
    },
  • "customerPONumber": "string",
  • "disableShipmentsReuse": true,
  • "discounts": [
    ],
  • "expectedDeliveryDate": "2019-08-24T14:15:22Z",
  • "extOrderApiId": "string",
  • "extOrderCreatedAt": "2019-08-24T14:15:22Z",
  • "extOrderId": "string",
  • "extOrderUpdatedAt": "2019-08-24T14:15:22Z",
  • "extOrderUrl": "string",
  • "fulfillmentStatus": "string",
  • "giftNote": "string",
  • "holdUntil": "2019-08-24T14:15:22Z",
  • "internal": {
    },
  • "isMultiAddress": true,
  • "lastRerunRoutingTrigger": "manual",
  • "lastRoutedAt": "2019-08-24T14:15:22Z",
  • "lineItems": [
    ],
  • "locationId": "string",
  • "orderDiscount": 0,
  • "orderNote": "string",
  • "orderSource": "string",
  • "orderSourceType": "online",
  • "orderTax": 0,
  • "paymentStatus": "string",
  • "paymentTerms": {
    },
  • "payments": [
    ],
  • "refunds": [
    ],
  • "requireShippingLabels": true,
  • "respectLocationId": true,
  • "routingStatus": "disabled",
  • "shipAfterDate": "2019-08-24T14:15:22Z",
  • "shipByDate": "2019-08-24T14:15:22Z",
  • "shipCancelByDate": "2019-08-24T14:15:22Z",
  • "shippingAddress": {
    },
  • "shippingCarrier": "string",
  • "shippingClass": "string",
  • "shippingCode": "string",
  • "shippingDestinations": [
    ],
  • "shippingNote": "string",
  • "shippingPrice": 0,
  • "sourceDoc": {
    },
  • "status": "draft",
  • "subTotalPrice": 0,
  • "tags": [
    ],
  • "timestamp": "2019-08-24T14:15:22Z",
  • "totalPrice": 0
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "order": {
    }
}

Products

Operations about Products

Product Model

name
required
string

Display Name

sku
required
string

Product SKU

Array of objects (ProductBundleItem)

Bundle Item need to reference the SKU of the actual product

cost
number <float>

Cost

costCurrency
string

Currency

countryOfOrigin
string

Country of Origin

createdAt
string <date-time>

When the object was created within Pipe17

Array of objects (NameValue)

Custom Fields

description
string

Description

dimensionsUnit
string
Enum: "cm" "in" "ft"

Dimensions UOM

exceptions
Array of strings

References to exceptions related to the product

extProductApiId
string

External Product API Id

extProductCreatedAt
string <date-time>
extProductId
string

External Product Id

extProductUpdatedAt
string <date-time>
harmonizedCode
string

Harmonized System/Tarrif Code

height
number <float>

Height

hideInStore
boolean

Mark item as hidden in marketplace Storefront

imageURLs
Array of strings

Image URLs

integration
string

Reference to integration that created an item

object (InternalInfo)

Internal info

inventoryNotTracked
boolean

Do not track inventory flag

length
number <float>

Length

object (ProductPublishedItem)
orgKey
string

Organization this object belong to

parentExtProductId
string

Variant parent external product Id

partId
string

Manufacturer part number

Array of objects (Price)

Start off with basePrice

productId
string

Product ID

Array of objects (ProductPublishedItem)

Published Channels

object (SourceDoc)

Vendor source document

status
string (ProductStatus)
Enum: "active" "inactive"

Product Status

tags
Array of strings (EntityTags)

Tags assigned to entity

taxable
boolean

Taxable

types
Array of strings (ProductType)
Items Enum: "simple" "bundle" "bundleItem" "child" "parent"

Product types

upc
string

UPC

updatedAt
string <date-time>

When the object was updated within Pipe17

Array of objects (NameValue)

this let us know the variant description

vendor
string

vendor

weight
number <float>

Weight

weightUnit
string
Enum: "lb" "oz" "kg" "g"

Weight UOM

width
number <float>

Width

{
  • "exceptions": [
    ],
  • "integration": "string",
  • "mappedProduct": {
    },
  • "productId": "string",
  • "name": "string",
  • "sku": "string",
  • "bundleItems": [
    ],
  • "cost": 0,
  • "costCurrency": "string",
  • "countryOfOrigin": "string",
  • "customFields": [
    ],
  • "description": "string",
  • "dimensionsUnit": "cm",
  • "extProductApiId": "string",
  • "extProductCreatedAt": "2019-08-24T14:15:22Z",
  • "extProductId": "string",
  • "extProductUpdatedAt": "2019-08-24T14:15:22Z",
  • "harmonizedCode": "string",
  • "height": 0,
  • "hideInStore": true,
  • "imageURLs": [
    ],
  • "internal": {
    },
  • "inventoryNotTracked": true,
  • "length": 0,
  • "parentExtProductId": "string",
  • "partId": "string",
  • "prices": [
    ],
  • "published": [
    ],
  • "sourceDoc": {
    },
  • "status": "active",
  • "tags": [
    ],
  • "taxable": true,
  • "types": [
    ],
  • "upc": "string",
  • "variantOptions": [
    ],
  • "vendor": "string",
  • "weight": 0,
  • "weightUnit": "lb",
  • "width": 0,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Products

Uniqueness constraints within organization:

  • product.sku
  • product.extProductId (when defined)
  • product.mappedProduct.sku, product.mappedProduct.integrationId
  • product.mappedProduct.extProductId, product.mappedProduct.integrationId
  • product.sku, product.mappedProduct.integrationId
  • product.sku, product.published.integrationId
  • product.published.integrationId, product.published.sku
  • product.published.integrationId, product.published.extProductId
Authorizations:
Pipe17KeyAuth
Request Body schema:
Array (<= 10 items)
name
required
string

Display Name

sku
required
string

Product SKU

Array of objects (ProductBundleItem)

Bundle Item need to reference the SKU of the actual product

cost
number <float>

Cost

costCurrency
string

Currency

countryOfOrigin
string

Country of Origin

Array of objects (NameValue)

Custom Fields

description
string

Description

dimensionsUnit
string
Enum: "cm" "in" "ft"

Dimensions UOM

extProductApiId
string

External Product API Id

extProductCreatedAt
string <date-time>
extProductId
string

External Product Id

extProductUpdatedAt
string <date-time>
harmonizedCode
string

Harmonized System/Tarrif Code

height
number <float>

Height

hideInStore
boolean

Mark item as hidden in marketplace Storefront

imageURLs
Array of strings

Image URLs

object (InternalInfo)

Internal info

inventoryNotTracked
boolean

Do not track inventory flag

length
number <float>

Length

parentExtProductId
string

Variant parent external product Id

partId
string

Manufacturer part number

Array of objects (Price)

Start off with basePrice

Array of objects (ProductPublishedItem)

Published Channels

object (SourceDoc)

Vendor source document

status
string (ProductStatus)
Enum: "active" "inactive"

Product Status

tags
Array of strings (EntityTags)

Tags assigned to entity

taxable
boolean

Taxable

types
Array of strings (ProductType)
Items Enum: "simple" "bundle" "bundleItem" "child" "parent"

Product types

upc
string

UPC

Array of objects (NameValue)

this let us know the variant description

vendor
string

vendor

weight
number <float>

Weight

weightUnit
string
Enum: "lb" "oz" "kg" "g"

Weight UOM

width
number <float>

Width

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "products": [
    ]
}

Delete Multiple Products

Authorizations:
Pipe17KeyAuth
query Parameters
action
string (ListDeleteAction)
Default: "list"
Enum: "list" "soft"

Return the list of what to delete, or delete softly

count
integer <int32>
Default: 100

Delete at most this many products

deleted
boolean

Delete soft deleted products

extProductId
Array of strings

Delete products by list of extProductId

integration
Array of strings

Delete products of these integrations

orgMode
Array of strings (OrganizationMode)
Items Enum: "sandbox" "production" "internal" "demo"

Delete products assigned these orgModes.

pagination
string
Value: "disabled"

Exclude pagination info from the response

parentExtProductId
Array of strings

Delete all variants of a parent product by list of external id

productId
Array of strings

Delete products by list of productId

since
string <date-time>

Delete products created after this date-time

skip
integer <int32>
Default: 0

Skip this many products

status
Array of strings (ProductStatus)
Items Enum: "active" "inactive"

Delete products with this status

types
Array of strings (ProductType)
Items Enum: "simple" "bundle" "bundleItem" "child" "parent"

Delete products matching specified types

until
string <date-time>

Delete products created before this date-time

updatedSince
string <date-time>

Delete products updated after this date-time

updatedUntil
string <date-time>

Delete products updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "deleted": 0,
  • "filters": {
    },
  • "pagination": {
    },
  • "products": [
    ]
}

Delete Product

Authorizations:
Pipe17KeyAuth
path Parameters
ProductId
required
string

Id, sku:{sku}, or ext:{extProductId} of product to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

List Products

Authorizations:
Pipe17KeyAuth
query Parameters
bundleSKU
string

Retrieve all products of the bundle with this SKU

count
integer <int32>
Default: 100

Return at most this many products

deleted
boolean

Retrieve soft deleted products

exceptionCategoryId
Array of strings

Retrieve products by list of categories of the product related exceptions

exceptionType
Array of strings

Retrieve products by list of types of the product related exceptions ({exceptionType} | {entityType}_{exceptionType})

extProductId
Array of strings

Retrieve products by list of extProductId

hasSourceDoc
boolean

Retrieve products containing a source document

inBundle
string

Retrieve all bundles containing the item with this SKU

inventoryNotTracked
boolean

Retrieve products by inventoryNotTracked value (default - any)

keys
string
Default: "inventoryNotTracked,productId,extProductId,parentExtProductId,status,types,sku,name,tags,createdAt,updatedAt,orgKey"

Return these top-level fields

mappedSKU
boolean

Retrieve products with SKU mapping defined

name
string

Retrieve products by name (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

notPublished
boolean

Retrieve products that do not have "published channels"

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

parentExtProductId
Array of strings

Retrieve all variants of a parent product by list of external id

productId
Array of strings

Retrieve by list of productId

publishedSKU
Array of strings

Retrieve all products with published SKU

publishedStatus
Array of strings (ProductPublishedItemStatus)
Items Enum: "tobepublished" "published" "tobeunpublished" "unpublished" "disabled"

Retrieve all products with published status

requestorId
string

Requestor Id (- forcibly replaced with integration ID if the request came from an integration)

since
string <date-time>

Retrieve all products created after this date-time

skip
integer <int32>
Default: 0

Skip this many products

sku
Array of strings

Retrieve products by list of SKU

status
Array of strings (ProductStatus)
Items Enum: "active" "inactive"

Retrieve all products with this status

types
Array of strings (ProductType)
Items Enum: "simple" "bundle" "bundleItem" "child" "parent"

Retrieve all products matching specified types

until
string <date-time>

Retrieve all products created before this date-time

updatedSince
string <date-time>

Retrieve all products updated after this date-time

updatedUntil
string <date-time>

Retrieve all products updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "products": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Retrieve Product

Authorizations:
Pipe17KeyAuth
path Parameters
ProductId
required
string

Id, sku:{sku}, or ext:{extProductId} of product to fetch

query Parameters
sourceDocVersion
number

Fetch specific vendor source doc version if available

withSourceDoc
boolean

Include vendor source doc if available

withSourceDocVersions
boolean

Include available vendor source doc versions

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "product": {
    }
}

Sync Products

Trigger the products sync

Authorizations:
Pipe17KeyAuth
path Parameters
ProductId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Product

Uniqueness constraints within organization:

  • product.sku
  • product.extProductId (when defined)
  • product.mappedProduct.sku, product.mappedProduct.integrationId
  • product.mappedProduct.extProductId, product.mappedProduct.integrationId
  • product.sku, product.mappedProduct.integrationId
  • product.sku, product.published.integrationId
  • product.published.integrationId, product.published.sku
  • product.published.integrationId, product.published.extProductId operationId: createProducts
Authorizations:
Pipe17KeyAuth
path Parameters
ProductId
required
string

Id, sku:{sku}, or ext:{extProductId} of product to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
Array of objects or null (ProductBundleItem)

Bundle Item need to reference the SKU of the actual product

cost
number or null <float>

Cost

costCurrency
string or null

Currency

countryOfOrigin
string or null

Country of Origin

Array of objects or null (NameValue)

Custom Fields

description
string

Description

dimensionsUnit
string
Enum: "cm" "in" "ft"

Dimensions UOM

extProductApiId
string

External Product API Id

extProductCreatedAt
string or null <date-time>
extProductUpdatedAt
string or null <date-time>
harmonizedCode
string or null

Harmonized System/Tariff Code

height
number or null <float>

Height

hideInStore
boolean or null

Mark item as hidden in marketplace Storefront

imageURLs
Array of strings or null

Image URLs

object (InternalInfo)

Internal info

inventoryNotTracked
boolean or null

Do not track inventory flag

length
number or null <float>

Length

object (ProductPublishedItemUpdate)
name
string

Display Name

parentExtProductId
string or null

Variant parent external product Id

partId
string or null

Manufacturer part number

Array of objects or null (Price)

Start off with basePrice

Array of objects or null (ProductPublishedItem)

Published Channels

sku
string

Product SKU

object (SourceDoc)

Vendor source document

status
string (ProductStatus)
Enum: "active" "inactive"

Product Status

tags
Array of strings (EntityTags)

Tags assigned to entity

taxable
boolean or null

Taxable

types
Array of strings (ProductType)
Items Enum: "simple" "bundle" "bundleItem" "child" "parent"

Product types

upc
string or null

UPC

Array of objects or null (NameValue)

this let us know the variant description

vendor
string or null

vendor

weight
number or null <float>

Weight

weightUnit
string or null
Enum: "lb" "oz" "kg" "g"

Weight UOM

width
number or null <float>

Width

Responses

Request samples

Content type
{
  • "bundleItems": [
    ],
  • "cost": 0,
  • "costCurrency": "string",
  • "countryOfOrigin": "string",
  • "customFields": [
    ],
  • "description": "string",
  • "dimensionsUnit": "cm",
  • "extProductApiId": "string",
  • "extProductCreatedAt": "2019-08-24T14:15:22Z",
  • "extProductUpdatedAt": "2019-08-24T14:15:22Z",
  • "harmonizedCode": "string",
  • "height": 0,
  • "hideInStore": true,
  • "imageURLs": [
    ],
  • "internal": {
    },
  • "inventoryNotTracked": true,
  • "length": 0,
  • "mappedProduct": {
    },
  • "name": "string",
  • "parentExtProductId": "string",
  • "partId": "string",
  • "prices": [
    ],
  • "published": [
    ],
  • "sku": "string",
  • "sourceDoc": {
    },
  • "status": "active",
  • "tags": [
    ],
  • "taxable": true,
  • "types": [
    ],
  • "upc": "string",
  • "variantOptions": [
    ],
  • "vendor": "string",
  • "weight": 0,
  • "weightUnit": "lb",
  • "width": 0
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "product": {
    }
}

Purchases

Operations about Purchase Orders

Purchase Model

extOrderId
required
string

External Purchase Order ID

actualArrivalDate
string <date-time>

Actual Arrival Date (from most recent Arrival)

object (Address)
Array of objects or null (PurchaseCosts)

Purchase costs

createdAt
string <date-time>

When the object was created within Pipe17

currency
string

Order currency code

Array of objects (NameValue)

Custom Fields

disableShipmentsReuse
boolean

Hint to whether shipmentId should be re-used, or not

employeeName
string

Purchase order created by

exceptions
Array of strings

References to exceptions related to the purchase

expectedArrivalDate
string <date-time>

Expected Arrival Date

holdUntil
string <date-time>
incoterms
string

International Commercial Terms

integration
string

Reference to integration that created an item

object (InternalInfo)

Internal info

Array of objects (PurchaseLineItem)
orgKey
string

Organization this object belong to

purchaseId
string

Purchase ID

purchaseNotes
string

Purchase Notes

purchaseOrderDate
string <date-time>

Purchase Order Date

purchaseTax
number <float>

Purchase Tax

referenceNumber
string

Purchase order reference number

shipByDate
string <date-time>

Ship By Date

shippingCarrier
string

Shipping Carrier

shippingNotes
string

Shipping Notes

shippingService
string

Shipping Service Type

object (SourceDoc)

Vendor source document

status
string (PurchaseStatus)
Enum: "draft" "new" "onHold" "toBeValidated" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "partialFulfillment" "fulfilled" "inTransit" "partialReceived" "received" "canceled" "returned" "refunded" "archived" "closed"

Purchase Status

subTotalPrice
number <float>

Sub Total Price

timestamp
string <date-time>

General Purpose Time Stamp

object (Address)
toLocationId
string

Ship to location ID

totalPrice
number <float>

Total Price

updatedAt
string <date-time>

When the object was updated within Pipe17

object (Address)
{
  • "exceptions": [
    ],
  • "integration": "string",
  • "purchaseId": "string",
  • "extOrderId": "string",
  • "actualArrivalDate": "2019-08-24T14:15:22Z",
  • "billingAddress": {
    },
  • "costs": [
    ],
  • "currency": "string",
  • "customFields": [
    ],
  • "disableShipmentsReuse": true,
  • "employeeName": "string",
  • "expectedArrivalDate": "2019-08-24T14:15:22Z",
  • "holdUntil": "2019-08-24T14:15:22Z",
  • "incoterms": "string",
  • "internal": {
    },
  • "lineItems": [
    ],
  • "purchaseNotes": "string",
  • "purchaseOrderDate": "2019-08-24T14:15:22Z",
  • "purchaseTax": 0,
  • "referenceNumber": "string",
  • "shipByDate": "2019-08-24T14:15:22Z",
  • "shippingCarrier": "string",
  • "shippingNotes": "string",
  • "shippingService": "string",
  • "sourceDoc": {
    },
  • "status": "draft",
  • "subTotalPrice": 0,
  • "timestamp": "2019-08-24T14:15:22Z",
  • "toAddress": {
    },
  • "toLocationId": "string",
  • "totalPrice": 0,
  • "vendorAddress": {
    },
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Purchases

Uniqueness constraints within organization:

  • purchase.extOrderId
Authorizations:
Pipe17KeyAuth
Request Body schema:
Array (<= 10 items)
extOrderId
required
string

External Purchase Order ID

actualArrivalDate
string <date-time>

Actual Arrival Date (from most recent Arrival)

object (Address)
Array of objects or null (PurchaseCosts)

Purchase costs

currency
string

Order currency code

Array of objects (NameValue)

Custom Fields

disableShipmentsReuse
boolean

Hint to whether shipmentId should be re-used, or not

employeeName
string

Purchase order created by

expectedArrivalDate
string <date-time>

Expected Arrival Date

holdUntil
string <date-time>
incoterms
string

International Commercial Terms

object (InternalInfo)

Internal info

Array of objects (PurchaseLineItem)
purchaseNotes
string

Purchase Notes

purchaseOrderDate
string <date-time>

Purchase Order Date

purchaseTax
number <float>

Purchase Tax

referenceNumber
string

Purchase order reference number

shipByDate
string <date-time>

Ship By Date

shippingCarrier
string

Shipping Carrier

shippingNotes
string

Shipping Notes

shippingService
string

Shipping Service Type

object (SourceDoc)

Vendor source document

status
string (PurchaseStatus)
Enum: "draft" "new" "onHold" "toBeValidated" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "partialFulfillment" "fulfilled" "inTransit" "partialReceived" "received" "canceled" "returned" "refunded" "archived" "closed"

Purchase Status

subTotalPrice
number <float>

Sub Total Price

timestamp
string <date-time>

General Purpose Time Stamp

object (Address)
toLocationId
string

Ship to location ID

totalPrice
number <float>

Total Price

object (Address)

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "purchases": [
    ]
}

Delete Multiple Purchases

Authorizations:
Pipe17KeyAuth
query Parameters
action
string (ListDeleteAction)
Default: "list"
Enum: "list" "soft"

Return the list of what to delete, or delete softly

count
integer <int32>
Default: 100

Delete at most this many purchases

deleted
boolean

Delete soft deleted purchaases

extOrderId
Array of strings

Delete purchases by list of external purchase IDs

integration
Array of strings

Delete purchases of these integrations

orgMode
Array of strings (OrganizationMode)
Items Enum: "sandbox" "production" "internal" "demo"

Delete purchases assigned these orgModes.

pagination
string
Value: "disabled"

Exclude pagination info from the response

purchaseId
Array of strings

Delete purchases by list of purchaseId

since
string <date-time>

Delete purchases created after this date-time

skip
integer <int32>
Default: 0

Skip this many purchases

status
Array of strings (PurchaseStatus)
Items Enum: "draft" "new" "onHold" "toBeValidated" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "partialFulfillment" "fulfilled" "inTransit" "partialReceived" "received" "canceled" "returned" "refunded" "archived" "closed"

Delete purchases by list of statuses

until
string <date-time>

Delete purchases created before this date-time

updatedSince
string <date-time>

Delete purchases updated after this date-time

updatedUntil
string <date-time>

Delete purchases updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "deleted": 0,
  • "filters": {
    },
  • "pagination": {
    },
  • "purchases": [
    ]
}

Delete Purchase

Authorizations:
Pipe17KeyAuth
path Parameters
PurchaseId
required
string

Id or ext:{extOrderId} of purchase order to delete

query Parameters
nested
boolean

Delete nested entities

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Purchase

Authorizations:
Pipe17KeyAuth
path Parameters
PurchaseId
required
string

Id or ext:{extOrderId} of purchase order to fetch

query Parameters
sourceDocVersion
number

Fetch specific vendor source doc version if available

withSourceDoc
boolean

Include vendor source doc if available

withSourceDocVersions
boolean

Include available vendor source doc versions

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "purchase": {
    }
}

List Purchases

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Return at most this many purchases

deleted
boolean

Retrieve soft deleted purchaases

exceptionCategoryId
Array of strings

Retrieve purchases by list of categories of the purchase related exceptions

exceptionType
Array of strings

Retrieve purchases by list of types of the purchase related exceptions ({exceptionType} | {entityType}_{exceptionType})

extOrderId
Array of strings

Retrieve by list of external purchase IDs

hasSourceDoc
boolean

Retrieve purchases containing a source document

keys
string
Default: "purchaseId,extOrderId,referenceNumber,vendorAddress,expectedArrivalDate,shipByDate,toLocationId,totalPrice,status,createdAt,updatedAt,orgKey"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

purchaseId
Array of strings

Retrieve by list of purchaseId

since
string <date-time>

Retrieve all purchases created after this date-time

skip
integer <int32>
Default: 0

Skip this many purchases

status
Array of strings (PurchaseStatus)
Items Enum: "draft" "new" "onHold" "toBeValidated" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "partialFulfillment" "fulfilled" "inTransit" "partialReceived" "received" "canceled" "returned" "refunded" "archived" "closed"

Retrieve by list of statuses

timestamp
boolean

if set to true use timestamp instead of create time

toLocationId
Array of strings

Retrieve by list of toLocationId

until
string <date-time>

Retrieve all purchases created before this date-time

updatedSince
string <date-time>

Retrieve all purchases updated after this date-time

updatedUntil
string <date-time>

Retrieve all purchases updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "purchases": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Sync Purchases

Trigger the purchases sync

Authorizations:
Pipe17KeyAuth
path Parameters
PurchaseId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Purchase

Uniqueness constraints within organization:

  • purchase.extOrderId
Authorizations:
Pipe17KeyAuth
path Parameters
PurchaseId
required
string

Id or ext:{extOrderId} of purchase order to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
actualArrivalDate
string or null <date-time>

Actual Arrival Date (from most recent Arrival)

object (AddressUpdateData)
Array of objects or null (PurchaseCosts)

Purchase costs

currency
string

Order currency code

Array of objects (NameValue)

Custom Fields

disableShipmentsReuse
boolean or null

Hint to whether shipmentId should be re-used, or not

employeeName
string or null

Purchase order created by

expectedArrivalDate
string or null <date-time>

Expected Arrival Date

holdUntil
string or null <date-time>
object (InternalInfo)

Internal info

Array of objects (PurchaseUpdateLineItem)
purchaseNotes
string or null

Purchase Notes

purchaseTax
number or null <float>

Purchase Tax

referenceNumber
string or null

Purchase order reference number

shipByDate
string or null <date-time>

Ship By Date

shippingCarrier
string or null

Shipping Carrier

shippingNotes
string or null

Shipping Notes

shippingService
string or null

Shipping Service Type

object (SourceDoc)

Vendor source document

status
string (PurchaseStatus)
Enum: "draft" "new" "onHold" "toBeValidated" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "partialFulfillment" "fulfilled" "inTransit" "partialReceived" "received" "canceled" "returned" "refunded" "archived" "closed"

Purchase Status

subTotalPrice
number or null <float>

Sub Total Price

timestamp
string or null <date-time>

General Purpose Time Stamp

object or null (AddressNullable)
toLocationId
string or null

Ship to location ID

totalPrice
number or null <float>

Total Price

object (AddressUpdateData)

Responses

Request samples

Content type
{
  • "actualArrivalDate": "2019-08-24T14:15:22Z",
  • "billingAddress": {
    },
  • "costs": [
    ],
  • "currency": "string",
  • "customFields": [
    ],
  • "disableShipmentsReuse": true,
  • "employeeName": "string",
  • "expectedArrivalDate": "2019-08-24T14:15:22Z",
  • "holdUntil": "2019-08-24T14:15:22Z",
  • "internal": {
    },
  • "lineItems": [
    ],
  • "purchaseNotes": "string",
  • "purchaseTax": 0,
  • "referenceNumber": "string",
  • "shipByDate": "2019-08-24T14:15:22Z",
  • "shippingCarrier": "string",
  • "shippingNotes": "string",
  • "shippingService": "string",
  • "sourceDoc": {
    },
  • "status": "draft",
  • "subTotalPrice": 0,
  • "timestamp": "2019-08-24T14:15:22Z",
  • "toAddress": {
    },
  • "toLocationId": "string",
  • "totalPrice": 0,
  • "vendorAddress": {
    }
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "purchase": {
    }
}

Receipts

Operations about Receipts

Receipt Model

arrivalId
required
string

Arrival ID

actualArrivalDate
string <date-time>

Actual arrival date

createdAt
string <date-time>

When the object was created within Pipe17

currency
string

Currency

Array of objects (NameValue)

Custom Fields

exceptions
Array of strings

References to exceptions related to the receipt

extOrderId
string

External Order ID

extReceiptId
string

Reference to receipt on external system (vendor)

integration
string

Reference to integration that created an item

object (InternalInfo)

Internal info

Array of objects (ReceiptItemWithRefs)
orgKey
string

Organization this object belong to

receiptId
string

Receipt ID

shippingCarrier
string

Shipping Carrier

shippingClass
string

Shipping Carrier

object (SourceDoc)

Vendor source document

Array of ArrivalChangelogEntry (object) or FulfillmentChangelogEntry (object) or ReceiptChangelogEntry (object) or ShipmentChangelogEntry (object) (ChangelogEntry)

Timeline of updates

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "exceptions": [
    ],
  • "extOrderId": "string",
  • "integration": "string",
  • "lineItems": [
    ],
  • "receiptId": "string",
  • "timeline": [
    ],
  • "arrivalId": "string",
  • "actualArrivalDate": "2019-08-24T14:15:22Z",
  • "currency": "string",
  • "customFields": [
    ],
  • "extReceiptId": "string",
  • "internal": {
    },
  • "shippingCarrier": "string",
  • "shippingClass": "string",
  • "sourceDoc": {
    },
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Arrival Receipts

Uniqueness constraints within organization:

  • receipt.extReceiptId (when defined)
Authorizations:
Pipe17KeyAuth
Request Body schema:
Array (<= 10 items)
arrivalId
required
string

Arrival ID

actualArrivalDate
string <date-time>

Actual arrival date

currency
string

Currency

Array of objects (NameValue)

Custom Fields

extReceiptId
string

Reference to receipt on external system (vendor)

object (InternalInfo)

Internal info

Array of objects (ReceiptItem)
shippingCarrier
string

Shipping Carrier

shippingClass
string

Shipping Carrier

object (SourceDoc)

Vendor source document

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "receipts": [
    ]
}

Fetch Receipt

Authorizations:
Pipe17KeyAuth
path Parameters
ReceiptId
required
string

Id or ext:{extReceiptId} of receipt to fetch

query Parameters
sourceDocVersion
number

Fetch specific vendor source doc version if available

withSourceDoc
boolean

Include vendor source doc if available

withSourceDocVersions
boolean

Include available vendor source doc versions

withTimeline
boolean

Include timeline of updates when available

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "receipt": {
    }
}

List Receipts

Authorizations:
Pipe17KeyAuth
query Parameters
arrivalId
Array of strings

Receipts by list of arrivalId

count
integer <int32>
Default: 100

Return at most this many receipts

exceptionCategoryId
Array of strings

Receipts by list of categories of the receipt related exceptions

exceptionType
Array of strings

Receipts by list of types of the receipt related exceptions ({exceptionType} | {entityType}_{exceptionType})

extOrderId
Array of strings

Receipts by list of extOrderId

hasSourceDoc
boolean

Receipts containing a source document

keys
string
Default: "receiptId,arrivalId,extOrderId,actualArrivalDate,createdAt,updatedAt,orgKey"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

receiptId
Array of strings

Receipts by list of receiptId

since
string <date-time>

Receipts created after this date-time

skip
integer <int32>
Default: 0

Skip this many receipts

until
string <date-time>

Receipts created before this date-time

updatedSince
string <date-time>

Receipts updated after this date-time

updatedUntil
string <date-time>

Receipts updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "receipts": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Sync Receipts

Trigger the receipts sync

Authorizations:
Pipe17KeyAuth
path Parameters
ReceiptId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Refunds

Operations about Refunds

Refund Model

returnId
required
string

Return ID

type
required
string (RefundType)
Enum: "refund" "voucher"

Refund type

amount
number <float>

Refund amount

createdAt
string <date-time>

When the object was created within Pipe17

creditIssued
number <float>

Credit issued to customer

creditSpent
number <float>

Credit spent by customer

currency
string

Refund currency

customerInvoiceAmount
number <float>

Customer invoice amount

Array of objects (NameValue)

Custom Fields

extOrderId
string

Order ID on external system

extRefundId
string

Refund ID on external system

integration
string

Reference to integration that created an item

object (InternalInfo)

Internal info

merchantInvoiceAmount
number <float>

Merchant invoice amount

orgKey
string

Organization this object belong to

refundId
string

Refund ID

object (SourceDoc)

Vendor source document

status
string (RefundStatus)
Enum: "pending" "settled"

Refund status

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "integration": "string",
  • "refundId": "string",
  • "returnId": "string",
  • "type": "refund",
  • "amount": 0,
  • "creditIssued": 0,
  • "creditSpent": 0,
  • "currency": "string",
  • "customFields": [
    ],
  • "customerInvoiceAmount": 0,
  • "extOrderId": "string",
  • "extRefundId": "string",
  • "internal": {
    },
  • "merchantInvoiceAmount": 0,
  • "sourceDoc": {
    },
  • "status": "pending",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Refund

Uniqueness constraints within organization:

  • refund.extRefundId (when defined)
Authorizations:
Pipe17KeyAuth
Request Body schema:
returnId
required
string

Return ID

type
required
string (RefundType)
Enum: "refund" "voucher"

Refund type

amount
number <float>

Refund amount

creditIssued
number <float>

Credit issued to customer

creditSpent
number <float>

Credit spent by customer

currency
string

Refund currency

customerInvoiceAmount
number <float>

Customer invoice amount

Array of objects (NameValue)

Custom Fields

extOrderId
string

Order ID on external system

extRefundId
string

Refund ID on external system

object (InternalInfo)

Internal info

merchantInvoiceAmount
number <float>

Merchant invoice amount

object (SourceDoc)

Vendor source document

status
string (RefundStatus)
Enum: "pending" "settled"

Refund status

Responses

Request samples

Content type
{
  • "returnId": "string",
  • "type": "refund",
  • "amount": 0,
  • "creditIssued": 0,
  • "creditSpent": 0,
  • "currency": "string",
  • "customFields": [
    ],
  • "customerInvoiceAmount": 0,
  • "extOrderId": "string",
  • "extRefundId": "string",
  • "internal": {
    },
  • "merchantInvoiceAmount": 0,
  • "sourceDoc": {
    },
  • "status": "pending"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "refund": {
    }
}

Delete Multiple Refunds

Authorizations:
Pipe17KeyAuth
query Parameters
action
string (ListDeleteAction)
Default: "list"
Enum: "list" "soft"

Return the list of what to delete, or delete softly

count
integer <int32>
Default: 100

Delete at most this many refunds

deleted
boolean

Delete soft deleted refunds

extOrderId
Array of strings

Delete refunds by list of external order ids

extRefundId
Array of strings

Delete refunds by list of external refund ids

extReturnId
Array of strings

Delete refunds by list of external return ids

integration
Array of strings

Delete refunds of these integrations

orgMode
Array of strings (OrganizationMode)
Items Enum: "sandbox" "production" "internal" "demo"

Delete refunds assigned these orgModes.

pagination
string
Value: "disabled"

Exclude pagination info from the response

refundId
Array of strings

Delete by list of refundId

since
string <date-time>

Delete refunds created after this date-time

skip
integer <int32>
Default: 0

Skip this many refunds

status
Array of strings (RefundStatus)
Items Enum: "pending" "settled"
type
Array of strings (RefundType)
Items Enum: "refund" "voucher"
until
string <date-time>

Delete refunds created before this date-time

updatedSince
string <date-time>

Delete refunds updated after this date-time

updatedUntil
string <date-time>

Delete refunds updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "deleted": 0,
  • "filters": {
    },
  • "pagination": {
    },
  • "refunds": [
    ]
}

Delete Refund

Authorizations:
Pipe17KeyAuth
path Parameters
RefundId
required
string

Id or ext:{extRefundId} of refund to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Refund

Authorizations:
Pipe17KeyAuth
path Parameters
RefundId
required
string

Id or ext:{extRefundId} of refund to fetch

query Parameters
sourceDocVersion
number

Fetch specific vendor source doc version if available

withSourceDoc
boolean

Include vendor source doc if available

withSourceDocVersions
boolean

Include available vendor source doc versions

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "refund": {
    }
}

List Refunds

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Return at most this many refunds

deleted
boolean

Retrieve soft deleted refunds

extOrderId
Array of strings

Retrieve refunds by list of external order ids

extRefundId
Array of strings

Retrieve refunds by list of external refund ids

extReturnId
Array of strings

Retrieve refunds by list of external return ids

hasSourceDoc
boolean

Retrieve refunds containing a source document

keys
string
Default: "refundId,extRefundId,status,createdAt,updatedAt,orgKey"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

refundId
Array of strings

Retrieve by list of refundId

returnId
Array of strings

Retrieve refunds by list of return ids

since
string <date-time>

Refunds created after this date-time

skip
integer <int32>
Default: 0

Skip this many refunds

status
Array of strings (RefundStatus)
Items Enum: "pending" "settled"
type
Array of strings (RefundType)
Items Enum: "refund" "voucher"
until
string <date-time>

Refunds created before this date-time

updatedSince
string <date-time>

Refunds updated after this date-time

updatedUntil
string <date-time>

Refunds updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "pagination": {
    },
  • "refunds": [
    ]
}

Sync Refunds

Trigger the refunds sync

Authorizations:
Pipe17KeyAuth
path Parameters
RefundId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Refund

Uniqueness constraints within organization:

  • refund.extRefundId (when defined)
Authorizations:
Pipe17KeyAuth
path Parameters
RefundId
required
string

Id or ext:{extRefundId} of refund to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
amount
number <float>

Refund amount

creditIssued
number <float>

Credit issued to customer

creditSpent
number <float>

Credit spent by customer

customerInvoiceAmount
number <float>

Customer invoice amount

Array of objects (NameValue)

Custom Fields

object (InternalInfo)

Internal info

merchantInvoiceAmount
number <float>

Merchant invoice amount

object (SourceDoc)

Vendor source document

status
string (RefundStatus)
Enum: "pending" "settled"

Refund status

Responses

Request samples

Content type
{
  • "amount": 0,
  • "creditIssued": 0,
  • "creditSpent": 0,
  • "customFields": [
    ],
  • "customerInvoiceAmount": 0,
  • "internal": {
    },
  • "merchantInvoiceAmount": 0,
  • "sourceDoc": {
    },
  • "status": "pending"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "refund": {
    }
}

Returns

Operations about Returns

Return Model

arrivedAt
string <date-time>
completedAt
string <date-time>
createdAt
string <date-time>

When the object was created within Pipe17

currency
string

Currency value, e.g. 'USD'

customerNotes
string

Customer notes

Array of objects (NameValue)

Custom Fields

discount
number <float>
estimatedTotal
number <float>
exceptions
Array of strings

References to exceptions related to the return

expectedArrivalDate
string <date-time>

Expected arrival date

extReferenceId
string
extReferenceUrl
string
extReturnId
string

Return ID on external system

fulfillmentIntegrationId
string

fulfillment integration Id

integration
string

Reference to integration that created an item

object (InternalInfo)

Internal info

isExchange
boolean
isGift
boolean
Array of objects (ReturnLineItem)
locationId
string

Destination location Id

notes
string

Merchant notes

orgKey
string

Organization this object belong to

Array of objects (ReturnReceipt)
refundedAt
string <date-time>
requiresShipping
boolean
restockingFee
number <float>
returnId
string

Return ID

object (Address)
shippingCarrier
string

shipping carrier

shippingLabelFee
number <float>
shippingPrice
number <float>
shippingQuote
number <float>
shippingRefund
number <float>
shippingService
string

shipping service

object (SourceDoc)

Vendor source document

status
string
Enum: "draft" "authorized" "shipped" "expected" "partialReceived" "received" "accepted" "refunded" "completed" "expired" "canceled" "deleted" "failed"

Return status

subTotal
number <float>
tax
number <float>
total
number <float>
trackingNumber
string

Tracking number

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "exceptions": [
    ],
  • "extReferenceId": "string",
  • "extReferenceUrl": "string",
  • "integration": "string",
  • "receipts": [
    ],
  • "returnId": "string",
  • "status": "draft",
  • "arrivedAt": "2019-08-24T14:15:22Z",
  • "completedAt": "2019-08-24T14:15:22Z",
  • "currency": "string",
  • "customFields": [
    ],
  • "customerNotes": "string",
  • "discount": 0,
  • "estimatedTotal": 0,
  • "expectedArrivalDate": "2019-08-24T14:15:22Z",
  • "extReturnId": "string",
  • "fulfillmentIntegrationId": "string",
  • "internal": {
    },
  • "isExchange": true,
  • "isGift": true,
  • "lineItems": [
    ],
  • "locationId": "string",
  • "notes": "string",
  • "refundedAt": "2019-08-24T14:15:22Z",
  • "requiresShipping": true,
  • "restockingFee": 0,
  • "shippingAddress": {
    },
  • "shippingCarrier": "string",
  • "shippingLabelFee": 0,
  • "shippingPrice": 0,
  • "shippingQuote": 0,
  • "shippingRefund": 0,
  • "shippingService": "string",
  • "sourceDoc": {
    },
  • "subTotal": 0,
  • "tax": 0,
  • "total": 0,
  • "trackingNumber": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Return

Uniqueness constraints within organization:

  • refund.extReturnId (when defined)
Authorizations:
Pipe17KeyAuth
Request Body schema:
arrivedAt
string <date-time>
completedAt
string <date-time>
currency
string

Currency value, e.g. 'USD'

customerNotes
string

Customer notes

Array of objects (NameValue)

Custom Fields

discount
number <float>
estimatedTotal
number <float>
expectedArrivalDate
string <date-time>

Expected arrival date

extReturnId
string

Return ID on external system

fulfillmentIntegrationId
string

fulfillment integration Id

object (InternalInfo)

Internal info

isExchange
boolean
isGift
boolean
Array of objects (ReturnLineItem)
locationId
string

Destination location Id

notes
string

Merchant notes

refundedAt
string <date-time>
requiresShipping
boolean
restockingFee
number <float>
object (Address)
shippingCarrier
string

shipping carrier

shippingLabelFee
number <float>
shippingPrice
number <float>
shippingQuote
number <float>
shippingRefund
number <float>
shippingService
string

shipping service

object (SourceDoc)

Vendor source document

status
string (ReturnStatus)
Enum: "draft" "authorized" "shipped" "expected" "partialReceived" "received" "accepted" "refunded" "completed" "expired" "canceled" "deleted" "failed"

Return status

subTotal
number <float>
tax
number <float>
total
number <float>
trackingNumber
string

Tracking number

Responses

Request samples

Content type
{
  • "arrivedAt": "2019-08-24T14:15:22Z",
  • "completedAt": "2019-08-24T14:15:22Z",
  • "currency": "string",
  • "customFields": [
    ],
  • "customerNotes": "string",
  • "discount": 0,
  • "estimatedTotal": 0,
  • "expectedArrivalDate": "2019-08-24T14:15:22Z",
  • "extReturnId": "string",
  • "fulfillmentIntegrationId": "string",
  • "internal": {
    },
  • "isExchange": true,
  • "isGift": true,
  • "lineItems": [
    ],
  • "locationId": "string",
  • "notes": "string",
  • "refundedAt": "2019-08-24T14:15:22Z",
  • "requiresShipping": true,
  • "restockingFee": 0,
  • "shippingAddress": {
    },
  • "shippingCarrier": "string",
  • "shippingLabelFee": 0,
  • "shippingPrice": 0,
  • "shippingQuote": 0,
  • "shippingRefund": 0,
  • "shippingService": "string",
  • "sourceDoc": {
    },
  • "status": "draft",
  • "subTotal": 0,
  • "tax": 0,
  • "total": 0,
  • "trackingNumber": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "return": {
    }
}

Delete Multiple Returns

Authorizations:
Pipe17KeyAuth
query Parameters
action
string (ListDeleteAction)
Default: "list"
Enum: "list" "soft"

Return the list of what to delete, or delete softly

count
integer <int32>
Default: 100

Delete at most this many returns

deleted
boolean

Delete soft deleted returns

extReturnId
Array of strings

Delete returns by list of external return ids

integration
Array of strings

Delete returns of these integrations

orgMode
Array of strings (OrganizationMode)
Items Enum: "sandbox" "production" "internal" "demo"

Delete returns assigned these orgModes.

pagination
string
Value: "disabled"

Exclude pagination info from the response

returnId
Array of strings

Delete returns by list of returnId

since
string <date-time>

Delete returns created after this date-time

skip
integer <int32>
Default: 0

Skip this many returns

status
Array of strings (ReturnStatus)
Items Enum: "draft" "authorized" "shipped" "expected" "partialReceived" "received" "accepted" "refunded" "completed" "expired" "canceled" "deleted" "failed"
until
string <date-time>

Delete returns created before this date-time

updatedSince
string <date-time>

Delete returns updated after this date-time

updatedUntil
string <date-time>

Delete returns updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "deleted": 0,
  • "filters": {
    },
  • "pagination": {
    },
  • "returns": [
    ]
}

Delete Return

Authorizations:
Pipe17KeyAuth
path Parameters
ReturnId
required
string

Id or ext:{extReturnId} of return to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Return

Authorizations:
Pipe17KeyAuth
path Parameters
ReturnId
required
string

Id or ext:{extReturnId} of return to fetch

query Parameters
sourceDocVersion
number

Fetch specific vendor source doc version if available

withSourceDoc
boolean

Include vendor source doc if available

withSourceDocVersions
boolean

Include available vendor source doc versions

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "return": {
    }
}

List Returns

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Return at most this many returns

deleted
boolean

Retrieve soft deleted returns

emailAddr
Array of strings

Retrieve by list of shippingAddress.email

exceptionCategoryId
Array of strings

Retrieve returns by list of categories of the return related exceptions

exceptionType
Array of strings

Retrieve returns by list of types of the return related exceptions ({exceptionType} | {entityType}_{exceptionType})

extOrderId
Array of strings

Retrieve returns by list of external order ids

extReturnId
Array of strings

Retrieve returns by list of external return ids

hasSourceDoc
boolean

Retrieve returns containing a source document

keys
string
Default: "returnId,extReturnId,status,createdAt,updatedAt,orgKey"

Return these top-level fields

locationId
Array of strings

Retrieve returns by list of location ids

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

returnId
Array of strings

Retrieve by list of returnId

since
string <date-time>

Returns created after this date-time

skip
integer <int32>
Default: 0

Skip this many returns

status
Array of strings (ReturnStatus)
Items Enum: "draft" "authorized" "shipped" "expected" "partialReceived" "received" "accepted" "refunded" "completed" "expired" "canceled" "deleted" "failed"
until
string <date-time>

Returns created before this date-time

updatedSince
string <date-time>

Returns updated after this date-time

updatedUntil
string <date-time>

Returns updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "pagination": {
    },
  • "returns": [
    ]
}

Sync Returns

Trigger the returns sync

Authorizations:
Pipe17KeyAuth
path Parameters
ReturnId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Return

Uniqueness constraints within organization:

  • refund.extReturnId (when defined)
Authorizations:
Pipe17KeyAuth
path Parameters
ReturnId
required
string

Id or ext:{extReturnId} of return to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
arrivedAt
string <date-time>
completedAt
string <date-time>
currency
string

Currency value, e.g. 'USD'

customerNotes
string

Customer notes

Array of objects (NameValue)

Custom Fields

discount
number <float>
estimatedTotal
number <float>
expectedArrivalDate
string <date-time>

Expected arrival date

extReferenceId
string
extReferenceUrl
string
fulfillmentIntegrationId
string

fulfillment integration Id

object (InternalInfo)

Internal info

isExchange
boolean
isGift
boolean
Array of objects (ReturnLineItem)
locationId
string

Destination location Id

notes
string

Merchant notes

Array of objects (ReturnReceipt)
refundedAt
string <date-time>
requiresShipping
boolean
restockingFee
number <float>
object (Address)
shippingCarrier
string

shipping carrier

shippingLabelFee
number <float>
shippingPrice
number <float>
shippingQuote
number <float>
shippingRefund
number <float>
shippingService
string

shipping service

object (SourceDoc)

Vendor source document

status
string (ReturnStatus)
Enum: "draft" "authorized" "shipped" "expected" "partialReceived" "received" "accepted" "refunded" "completed" "expired" "canceled" "deleted" "failed"

Return status

subTotal
number <float>
tax
number <float>
total
number <float>
trackingNumber
string

Tracking number

Responses

Request samples

Content type
{
  • "arrivedAt": "2019-08-24T14:15:22Z",
  • "completedAt": "2019-08-24T14:15:22Z",
  • "currency": "string",
  • "customFields": [
    ],
  • "customerNotes": "string",
  • "discount": 0,
  • "estimatedTotal": 0,
  • "expectedArrivalDate": "2019-08-24T14:15:22Z",
  • "extReferenceId": "string",
  • "extReferenceUrl": "string",
  • "fulfillmentIntegrationId": "string",
  • "internal": {
    },
  • "isExchange": true,
  • "isGift": true,
  • "lineItems": [
    ],
  • "locationId": "string",
  • "notes": "string",
  • "receipts": [
    ],
  • "refundedAt": "2019-08-24T14:15:22Z",
  • "requiresShipping": true,
  • "restockingFee": 0,
  • "shippingAddress": {
    },
  • "shippingCarrier": "string",
  • "shippingLabelFee": 0,
  • "shippingPrice": 0,
  • "shippingQuote": 0,
  • "shippingRefund": 0,
  • "shippingService": "string",
  • "sourceDoc": {
    },
  • "status": "draft",
  • "subTotal": 0,
  • "tax": 0,
  • "total": 0,
  • "trackingNumber": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "return": {
    }
}

Shipment Boxes

Operations about Shipment Boxes

Shipment Box Model

extBoxId
required
string

External Box Id

billOfLading
string
boxId
string

Box Id

createdAt
string <date-time>

When the object was created within Pipe17

Array of objects or null (NameValue)

Custom Fields

dimensionsUnit
string
Enum: "cm" "in" "ft"

Dimensions UOM

height
number <float>

Height

object (InternalInfo)

Internal info

labelId
Array of strings

Label Ids

length
number <float>

Length

Array of objects (ShipmentBoxLineItem)
orgKey
string

Organization this object belong to

shipmentId
string

Shipment Id

ssccCode
string
status
string (ShipmentBoxStatus)
Enum: "new" "packed" "reported" "labeled" "shipped"

Box Status

ucc128
string
updatedAt
string <date-time>

When the object was updated within Pipe17

weight
number <float>

Weight

weightUnit
string
Enum: "lb" "oz" "kg" "g"

Weight UOM

width
number <float>

Width

{
  • "boxId": "string",
  • "extBoxId": "string",
  • "billOfLading": "string",
  • "customFields": [
    ],
  • "dimensionsUnit": "cm",
  • "height": 0,
  • "internal": {
    },
  • "labelId": [
    ],
  • "length": 0,
  • "lineItems": [
    ],
  • "shipmentId": "string",
  • "ssccCode": "string",
  • "status": "new",
  • "ucc128": "string",
  • "weight": 0,
  • "weightUnit": "lb",
  • "width": 0,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Shipment Box

Uniqueness constraints within organization:

  • box.extBoxId
Authorizations:
Pipe17KeyAuth
Request Body schema:
extBoxId
required
string

External Box Id

billOfLading
string
Array of objects or null (NameValue)

Custom Fields

dimensionsUnit
string
Enum: "cm" "in" "ft"

Dimensions UOM

height
number <float>

Height

object (InternalInfo)

Internal info

labelId
Array of strings

Label Ids

length
number <float>

Length

Array of objects (ShipmentBoxLineItem)
shipmentId
string

Shipment Id

ssccCode
string
status
string (ShipmentBoxStatus)
Enum: "new" "packed" "reported" "labeled" "shipped"

Box Status

ucc128
string
weight
number <float>

Weight

weightUnit
string
Enum: "lb" "oz" "kg" "g"

Weight UOM

width
number <float>

Width

Responses

Request samples

Content type
{
  • "extBoxId": "string",
  • "billOfLading": "string",
  • "customFields": [
    ],
  • "dimensionsUnit": "cm",
  • "height": 0,
  • "internal": {
    },
  • "labelId": [
    ],
  • "length": 0,
  • "lineItems": [
    ],
  • "shipmentId": "string",
  • "ssccCode": "string",
  • "status": "new",
  • "ucc128": "string",
  • "weight": 0,
  • "weightUnit": "lb",
  • "width": 0
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "box": {
    }
}

Delete Shipment Box

Authorizations:
Pipe17KeyAuth
path Parameters
BoxId
required
string

Box Id to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Shipment Box

Authorizations:
Pipe17KeyAuth
path Parameters
BoxId
required
string

Box Id to fetch

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "box": {
    }
}

List Shipment Boxes

Authorizations:
Pipe17KeyAuth
query Parameters
boxId
Array of strings

Retrieve by list of boxId

count
integer <int32>
Default: 100

Return at most this many shipment boxes

extBoxId
Array of strings

Retrieve shipment by list of extBoxId

keys
string
Default: "boxId,extBoxId,shipmentId,createdAt,updatedAt,orgKey,status"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

shipmentId
Array of strings

Retrieve shipment by list of shipmentId

since
string <date-time>

Shipment boxes created after this date-time

skip
integer <int32>
Default: 0

Skip this many shipment boxes

status
Array of strings (ShipmentBoxStatus)
Items Enum: "new" "packed" "reported" "labeled" "shipped"
until
string <date-time>

Shipment boxes created before this date-time

updatedSince
string <date-time>

Shipment boxes updated after this date-time

updatedUntil
string <date-time>

Shipment boxes updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "boxes": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Sync Shipment Boxes

Trigger the shipment boxes sync

Authorizations:
Pipe17KeyAuth
path Parameters
BoxId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Shipment Box

Uniqueness constraints within organization:

  • box.name, box.integration
Authorizations:
Pipe17KeyAuth
path Parameters
BoxId
required
string

Box Id to update

Request Body schema:
billOfLading
string
Array of objects or null (NameValue)

Custom Fields

dimensionsUnit
string
Enum: "cm" "in" "ft"

Dimensions UOM

height
number <float>

Height

object (InternalInfo)

Internal info

labelId
Array of strings

Label Ids

length
number <float>

Length

Array of objects (ShipmentBoxUpdateLineItem)
shipmentId
string

Shipment Id

ssccCode
string
status
string (ShipmentBoxStatus)
Enum: "new" "packed" "reported" "labeled" "shipped"

Box Status

ucc128
string
weight
number <float>

Weight

weightUnit
string
Enum: "lb" "oz" "kg" "g"

Weight UOM

width
number <float>

Width

Responses

Request samples

Content type
{
  • "billOfLading": "string",
  • "customFields": [
    ],
  • "dimensionsUnit": "cm",
  • "height": 0,
  • "internal": {
    },
  • "labelId": [
    ],
  • "length": 0,
  • "lineItems": [
    ],
  • "shipmentId": "string",
  • "ssccCode": "string",
  • "status": "new",
  • "ucc128": "string",
  • "weight": 0,
  • "weightUnit": "lb",
  • "width": 0
}

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Shipping Methods

Operations about Shipping Methods

Shipping Method Model

sourceType
required
string (ShippingMethodSourceType)
Enum: "logistics" "ecommerce" "finance"

Shipping Source type

createdAt
string <date-time>

When the object was created within Pipe17

description
string

Shipping method description

extMethodId
string

Shipping method external Id

integration
string

Reference to integration that created an item

object (InternalInfo)

Internal info

isDefault
boolean

Marks shipping method as default for given sourceIntegrationId

isPassthrough
boolean

Marks shipping method as passthrough for given sourceIntegrationId

Array of objects (ShippingMethodMapping)

List of mapped methods

methodId
string

Shipping Method ID

name
string

Shipping method name

orgKey
string

Organization this object belong to

shippingCarrier
string

Shipping carrier

shippingCode
string

Shipping code

shippingService
string

Shipping service

sourceIntegrationId
string

Shipping method source integrationId

status
string (ShippingMethodStatus)
Enum: "active" "inactive" "deleted"

Shipping Method status

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "integration": "string",
  • "methodId": "string",
  • "sourceType": "logistics",
  • "description": "string",
  • "extMethodId": "string",
  • "internal": {
    },
  • "isDefault": true,
  • "isPassthrough": true,
  • "mappedMethods": [
    ],
  • "name": "string",
  • "shippingCarrier": "string",
  • "shippingCode": "string",
  • "shippingService": "string",
  • "sourceIntegrationId": "string",
  • "status": "active",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Shipping Method

Uniqueness constraints within organization:

  • method.source, method.shippingCarrier, method.shippingService, method.shippingCode
Authorizations:
Pipe17KeyAuth
Request Body schema:
Array (<= 10 items)
sourceType
required
string (ShippingMethodSourceType)
Enum: "logistics" "ecommerce" "finance"

Shipping Source type

description
string

Shipping method description

extMethodId
string

Shipping method external Id

object (InternalInfo)

Internal info

isDefault
boolean

Marks shipping method as default for given sourceIntegrationId

isPassthrough
boolean

Marks shipping method as passthrough for given sourceIntegrationId

Array of objects (ShippingMethodMapping)

List of mapped methods

name
string

Shipping method name

shippingCarrier
string

Shipping carrier

shippingCode
string

Shipping code

shippingService
string

Shipping service

sourceIntegrationId
string

Shipping method source integrationId

status
string (ShippingMethodStatus)
Enum: "active" "inactive" "deleted"

Shipping Method status

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "methods": [
    ]
}

Delete Multiple Shipping Methods

Authorizations:
Pipe17KeyAuth
query Parameters
action
string (ListDeleteAction)
Default: "list"
Enum: "list" "soft"

Return the list of what to delete, or delete softly

count
integer <int32>
Default: 100

Delete at most this many shipping methods

methodId
Array of strings

Delete shipping methods by list of methodId

orgMode
Array of strings (OrganizationMode)
Items Enum: "sandbox" "production" "internal" "demo"

Delete shipping methods assigned these orgModes.

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Delete shipping methods created after this date-time

skip
integer <int32>
Default: 0

Skip this many shipping methods

until
string <date-time>

Delete shipping methods created before this date-time

updatedSince
string <date-time>

Delete shipping methods updated after this date-time

updatedUntil
string <date-time>

Delete shipping methods updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "deleted": 0,
  • "filters": {
    },
  • "methods": [
    ],
  • "pagination": {
    }
}

Delete Shipping Method

Authorizations:
Pipe17KeyAuth
path Parameters
MethodId
required
string

Id or ext:{extMethodId} of shipping method to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Shipping Method

Authorizations:
Pipe17KeyAuth
path Parameters
MethodId
required
string

Id or ext:{extMethodId} of shipping method to fetch

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "method": {
    }
}

List Shipping Methods

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Return at most this many shipping methods

isDefault
boolean

Shipping method default flag

isPassthrough
boolean

Shipping method passthrough flag

keys
string
Default: "methodId,name,createdAt,updatedAt,orgKey"

Return these top-level fields

mappedMethodId
Array of strings

Mapped shipping method Ids

methodId
Array of strings

Retrieve by list of methodId

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

shippingCarrier
Array of strings

Retrieve by list of shipping carriers

shippingCode
Array of strings

Retrieve by list of shipping codes

shippingService
Array of strings

Retrieve by list of shipping services

since
string <date-time>

Shipping Methods created after this date-time

skip
integer <int32>
Default: 0

Skip this many shipping methods

sourceIntegrationId
Array of strings

Shipping method source IntegrationIds

sourceType
Array of strings (ShippingMethodSourceType)
Items Enum: "logistics" "ecommerce" "finance"

Shipping method source types

status
Array of strings (ShippingMethodStatus)
Items Enum: "active" "inactive" "deleted"

Shipping method statuses

until
string <date-time>

Shipping Methods created before this date-time

updatedSince
string <date-time>

Shipping Methods updated after this date-time

updatedUntil
string <date-time>

Shipping Methods updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "methods": [
    ],
  • "pagination": {
    }
}

Sync Shipping Methods

Trigger the shipping methods sync

Authorizations:
Pipe17KeyAuth
path Parameters
MethodId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Shipping Method

Uniqueness constraints within organization:

  • method.source, method.shippingCarrier, method.shippingService, method.shippingCode
Authorizations:
Pipe17KeyAuth
path Parameters
MethodId
required
string

Id or ext:{extMethodId} of shipping method to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
description
string

Shipping method description

object (InternalInfo)

Internal info

isDefault
boolean

Marks shipping method as default for given sourceIntegrationId

isPassthrough
boolean

Marks shipping method as passthrough for given sourceIntegrationId

Array of objects or null (ShippingMethodMapping)

List of mapped methods

name
string

Shipping method name

shippingCarrier
string or null

Shipping carrier

shippingCode
string or null

Shipping code

shippingService
string or null

Shipping service

status
string (ShippingMethodStatus)
Enum: "active" "inactive" "deleted"

Shipping Method status

Responses

Request samples

Content type
{
  • "description": "string",
  • "internal": {
    },
  • "isDefault": true,
  • "isPassthrough": true,
  • "mappedMethods": [
    ],
  • "name": "string",
  • "shippingCarrier": "string",
  • "shippingCode": "string",
  • "shippingService": "string",
  • "status": "active"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "method": {
    }
}

Shipping Requests

Operations with shipping requests. The obsolete /shipments path will be supported along with /shipping_requests until further notice.

Shipping Request Model

extOrderId
required
string

Customer friendly ID on the order object

required
object (Address)
autoEngUpdateStatus
string (AutoEngUpdateStatus)
Enum: "pending" "updated" "none"

A status that indicates whether or not the automation engine may update the entity sometime in the future. Only set internally. Useful for services such as the order routing engine where the user intended order state is critical before action. Used for orders and shipments.

Status definitions:

  • pending: the automation engine will make an update to this entity in the future.
  • updated: the automation engine has successfully made an update to this entity.
  • none: No status to set because the org did not have an enabled automation at the time of create/update.
autoEngUpdateStatusUpdatedAt
string <date-time> (AutoEngUpdateStatusUpdatedAt)

When the autoEngUpdateStatus was last updated

canceledAt
string <date-time>

The cancellation date

canceledBy
string

The cancel requester Id

canceledByType
string
Enum: "user" "integration" "apikey"

The cancel requester Id type

cancellationStatus
string (ShipmentCancellationStatus)
Enum: "pending" "accepted" "rejected"

Shipping request cancellation status

createdAt
string <date-time>

When the object was created within Pipe17

currency
string

Currency code (inherited from order)

Array of objects (NameValue)

Custom Fields

exceptions
Array of strings

References to exceptions related to the shipment

expectedDeliveryDate
string <date-time>

First Priority to be respected

expectedShipDate
string <date-time>

Expected ship date

extOrderApiId
string

External System Order API ID

extReferenceId
string

Customer Friendly reference to this shipping request on destination vendor

extReferenceUrl
string

Direct link to this shipping request on destination vendor

extShipmentId
string

Customer Friendly reference to this shipping request on originating vendor, auto generated if not provided

fulfillmentIntegrationId
string

Destination of this shipping request

giftNote
string

Shipping Gift note

holdUntil
string <date-time>
incoterms
string

International Commercial Terms

integration
string

Reference to integration that created an item

object (InternalInfo)

Internal info

Array of objects (ShipmentLineItem)
locationId
string

Id of location defined in organization

orderCreateTime
string <date-time>

Create time of linked order

orderId
string

Pipe17 Internal Order's orderId

orderIntegration
string

Reference to integration that created order tied to an item

orderSource
string

Actual Order source, Walmart, Etsy, etc

orderSourceType
string (OrderType)
Enum: "online" "pos" "wholesale" "edi" "other" "b2b"

Order Type (online, pos, etc)

orderType
string (ShipmentOrderType)
Enum: "sales" "transfer" "purchase"

Type of order that initiated this shipping request

orgKey
string

Organization this object belong to

overfulfillPolicy
string (OverfulfillPolicy)
Enum: "strict" "report" "approved"

Overfulfill policy

reused
boolean

Indicates the shipment's extShipmentId is being reused in another one

sentToFulfillmentAt
string <date-time>

Sent to fulfillment timestamp

shipAfterDate
string <date-time>

Ship After Date

shipByDate
string <date-time>

Ship By Date

shipCancelByDate
string <date-time>

Ship Cancel By Date

shipmentId
string

Shipment ID

shippingCarrier
string

Required with ShippingClass, 2nd Priority

shippingClass
string

Required with ShippingCarrier, 2nd Priority

shippingCode
string

1st Priority

shippingLabels
Array of strings

Shipping Labels

shippingMethodMapping
boolean

Enable shipping method mapping (defaults to company setting if not provided)

shippingNote
string

Shipping Note

shippingPrice
number <float>

Shipping price

skipLocation
boolean

A flag to indicate the location in this SR should be skipped during rerun-routing

object (SourceDoc)

Vendor source document

status
string
Enum: "new" "pendingInventory" "pendingShippingLabel" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "fulfilled" "partialFulfillment" "canceled" "canceledRestock" "failed" "onHold"

Shipping request Status

tags
Array of strings (EntityTags)

Tags assigned to entity

Array of ArrivalChangelogEntry (object) or FulfillmentChangelogEntry (object) or ReceiptChangelogEntry (object) or ShipmentChangelogEntry (object) (ChangelogEntry)

Timeline of updates

updatedAt
string <date-time>

When the object was updated within Pipe17

version
number

Shipping request ordinal number - each new shipping request will have this value incremented for the same orderId

{
  • "autoEngUpdateStatus": "pending",
  • "autoEngUpdateStatusUpdatedAt": "2019-08-24T14:15:22Z",
  • "canceledAt": "2019-08-24T14:15:22Z",
  • "canceledBy": "string",
  • "canceledByType": "user",
  • "cancellationStatus": "pending",
  • "exceptions": [
    ],
  • "extOrderApiId": "string",
  • "integration": "string",
  • "orderIntegration": "string",
  • "reused": true,
  • "sentToFulfillmentAt": "2019-08-24T14:15:22Z",
  • "shipmentId": "string",
  • "status": "new",
  • "timeline": [
    ],
  • "version": 0,
  • "extOrderId": "string",
  • "shippingAddress": {
    },
  • "currency": "string",
  • "customFields": [
    ],
  • "expectedDeliveryDate": "2019-08-24T14:15:22Z",
  • "expectedShipDate": "2019-08-24T14:15:22Z",
  • "extReferenceId": "string",
  • "extReferenceUrl": "string",
  • "extShipmentId": "string",
  • "fulfillmentIntegrationId": "string",
  • "giftNote": "string",
  • "holdUntil": "2019-08-24T14:15:22Z",
  • "incoterms": "string",
  • "internal": {
    },
  • "lineItems": [
    ],
  • "locationId": "string",
  • "orderCreateTime": "2019-08-24T14:15:22Z",
  • "orderId": "string",
  • "orderSource": "string",
  • "orderSourceType": "online",
  • "orderType": "sales",
  • "overfulfillPolicy": "strict",
  • "shipAfterDate": "2019-08-24T14:15:22Z",
  • "shipByDate": "2019-08-24T14:15:22Z",
  • "shipCancelByDate": "2019-08-24T14:15:22Z",
  • "shippingCarrier": "string",
  • "shippingClass": "string",
  • "shippingCode": "string",
  • "shippingLabels": [
    ],
  • "shippingMethodMapping": true,
  • "shippingNote": "string",
  • "shippingPrice": 0,
  • "skipLocation": true,
  • "sourceDoc": {
    },
  • "tags": [
    ],
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Shipping Requests

Uniqueness constraints within organization:

  • shipment.extShipmentId (when defined)
  • shipment.extReferenceId, shipment.fulfillmentIntegrationId (when extReferenceId defined)
Authorizations:
Pipe17KeyAuth
Request Body schema:
Array (<= 10 items)
extOrderId
required
string

Customer friendly ID on the order object

required
object (Address)
currency
string

Currency code (inherited from order)

Array of objects (NameValue)

Custom Fields

expectedDeliveryDate
string <date-time>

First Priority to be respected

expectedShipDate
string <date-time>

Expected ship date

extReferenceId
string

Customer Friendly reference to this shipping request on destination vendor

extReferenceUrl
string

Direct link to this shipping request on destination vendor

extShipmentId
string

Customer Friendly reference to this shipping request on originating vendor, auto generated if not provided

fulfillmentIntegrationId
string

Destination of this shipping request

giftNote
string

Shipping Gift note

holdUntil
string <date-time>
incoterms
string

International Commercial Terms

object (InternalInfo)

Internal info

Array of objects (ShipmentLineItem)
locationId
string

Id of location defined in organization

orderCreateTime
string <date-time>

Create time of linked order

orderId
string

Pipe17 Internal Order's orderId

orderSource
string

Actual Order source, Walmart, Etsy, etc

orderSourceType
string (OrderType)
Enum: "online" "pos" "wholesale" "edi" "other" "b2b"

Order Type (online, pos, etc)

orderType
string (ShipmentOrderType)
Enum: "sales" "transfer" "purchase"

Type of order that initiated this shipping request

overfulfillPolicy
string (OverfulfillPolicy)
Enum: "strict" "report" "approved"

Overfulfill policy

shipAfterDate
string <date-time>

Ship After Date

shipByDate
string <date-time>

Ship By Date

shipCancelByDate
string <date-time>

Ship Cancel By Date

shippingCarrier
string

Required with ShippingClass, 2nd Priority

shippingClass
string

Required with ShippingCarrier, 2nd Priority

shippingCode
string

1st Priority

shippingLabels
Array of strings

Shipping Labels

shippingMethodMapping
boolean

Enable shipping method mapping (defaults to company setting if not provided)

shippingNote
string

Shipping Note

shippingPrice
number <float>

Shipping price

skipLocation
boolean

A flag to indicate the location in this SR should be skipped during rerun-routing

object (SourceDoc)

Vendor source document

status
string (ShipmentCreateStatus)
Enum: "new" "pendingInventory" "pendingShippingLabel" "reviewRequired" "readyForFulfillment"

Shipment Status

tags
Array of strings (EntityTags)

Tags assigned to entity

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "shipments": [
    ]
}

Delete Multiple Shipping Requests

Authorizations:
Pipe17KeyAuth
query Parameters
action
string (ListDeleteAction)
Default: "list"
Enum: "list" "soft"

Return the list of what to delete, or delete softly

count
integer <int32>
Default: 100

Delete at most this many shipping requests

deleted
boolean

Soft deleted shipping requests

extOrderId
Array of strings

Shipping requests by list of External Order Ids

integration
Array of strings

Shipping requests of these integrations

orderId
Array of strings

Shipping requests by list of Pipe17 Order Ids

orderType
Array of strings (ShipmentOrderType)
Items Enum: "sales" "transfer" "purchase"

Shipping requests by list of order types

orgMode
Array of strings (OrganizationMode)
Items Enum: "sandbox" "production" "internal" "demo"

Delete shipping requests assigned these orgModes.

pagination
string
Value: "disabled"

Exclude pagination info from the response

shipmentId
Array of strings

Shipping requests by list of shipmentId

since
string <date-time>

Shipping requests created after this date-time

skip
integer <int32>
Default: 0

Skip this many shipping requests

status
Array of strings (ShipmentStatus)
Items Enum: "new" "pendingInventory" "pendingShippingLabel" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "fulfilled" "partialFulfillment" "canceled" "canceledRestock" "failed" "onHold"

Shipping requests by list of statuses

until
string <date-time>

Shipping requests created before this date-time

updatedSince
string <date-time>

Shipping requests updated after this date-time

updatedUntil
string <date-time>

Shipping requests updated before this date-time

version
number

Shipping requests by version number

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "deleted": 0,
  • "filters": {
    },
  • "pagination": {
    },
  • "shipments": [
    ]
}

Delete Shipping Request

Authorizations:
Pipe17KeyAuth
path Parameters
ShipmentId
required
string

Id, ext:{extShipmentId}, or ref:{extReferenceId} of shipping request to delete

query Parameters
nested
boolean

Delete nested entities

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Shipping Request

Authorizations:
Pipe17KeyAuth
path Parameters
ShipmentId
required
string

Id, ext:{extShipmentId}, or ref:{extReferenceId} of shipping request to fetch

query Parameters
sourceDocVersion
number

Fetch specific vendor source doc version if available

withSourceDoc
boolean

Include vendor source doc if available

withSourceDocVersions
boolean

Include available vendor source doc versions

withTimeline
boolean

Include timeline of updates when available

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "shipment": {
    }
}

List Shipping Requests

Authorizations:
Pipe17KeyAuth
query Parameters
autoEngUpdateStatus
Array of strings (AutoEngUpdateStatus)
Items Enum: "pending" "updated" "none"
autoEngUpdateStatusUpdatedSince
string <date-time>

Fetch all shipping requests with autoEngUpdateStatus updated after this date-time

autoEngUpdateStatusUpdatedUntil
string <date-time>

Fetch all shipping requests with autoEngUpdateStatus updated before this date-time

cancellationStatus
Array of strings (ShipmentCancellationStatus)
Items Enum: "pending" "accepted" "rejected"
count
integer <int32>
Default: 100

Return at most this many shipping requests

deleted
boolean

Soft deleted shipping requests

emailAddr
Array of strings

Shipping requests by list of shippingAddress.email

exceptionCategoryId
Array of strings

Shipping requests by list of categories of the request related exceptions

exceptionType
Array of strings

Shipping requests by list of types of the request related exceptions ({exceptionType} | {entityType}_{exceptionType})

extOrderId
Array of strings

Shipping requests by list of External Order Ids

extReferenceId
Array of strings

Shipping requests by list of extReferenceId

extShipmentId
Array of strings

Shipping requests by list of extShipmentId

fulfillmentIntegrationId
Array of strings

Shipping requests by list of fulfillmentIntegrationId

hasSourceDoc
boolean

Shipping requests containing a source document

holdUntilSince
string <date-time>

Fetch all shipping requests with holdUntil after or at this date-time. Rounded down to the nearest minute

holdUntilUntil
string <date-time>

Fetch all shipping requests with holdUntil before or at this date-time. Rounded down to the nearest minute

keys
string
Default: "shipmentId,status,extShipmentId,extReferenceId,orderId,extOrderId,orderType,orderCreateTime,shipByDate,expectedDeliveryDate,sentToFulfillmentAt,tags,createdAt,updatedAt,orgKey,version"

Return these top-level fields

locationId
Array of strings

Shipping requests by list of locationId

order
string
Default: "createdAt"

Sort by these top-level fields

orderId
Array of strings

Shipping requests by list of Pipe17 Order Ids

orderType
Array of strings (ShipmentOrderType)
Items Enum: "sales" "transfer" "purchase"

Shipping requests by list of order types

pagination
string
Value: "disabled"

Exclude pagination info from the response

shipmentId
Array of strings

Shipping requests by list of shipmentId

since
string <date-time>

Shipping requests created after this date-time

skip
integer <int32>
Default: 0

Skip this many shipping requests

status
Array of strings (ShipmentStatus)
Items Enum: "new" "pendingInventory" "pendingShippingLabel" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "fulfilled" "partialFulfillment" "canceled" "canceledRestock" "failed" "onHold"

Shipping requests by list of statuses

until
string <date-time>

Shipping requests created before this date-time

updatedSince
string <date-time>

Shipping requests updated after this date-time

updatedUntil
string <date-time>

Shipping requests updated before this date-time

version
number

Shipping requests by version number

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "shipments": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Sync Shipping Requests

Trigger the shipping requests sync

Authorizations:
Pipe17KeyAuth
path Parameters
ShipmentId
required
Array of strings
Request Body schema:
syncAE
boolean

Reset autoEngUpdateStatus

Responses

Request samples

Content type
{
  • "syncAE": true
}

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Shipping Request

Uniqueness constraints within organization:

  • shipment.extShipmentId (when defined)
  • shipment.extReferenceId, shipment.fulfillmentIntegrationId (when extReferenceId defined)
Authorizations:
Pipe17KeyAuth
path Parameters
ShipmentId
required
string

Shipping Request Id to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
autoEngUpdateStatus
string (AutoEngUpdateStatus)
Enum: "pending" "updated" "none"

A status that indicates whether or not the automation engine may update the entity sometime in the future. Only set internally. Useful for services such as the order routing engine where the user intended order state is critical before action. Used for orders and shipments.

Status definitions:

  • pending: the automation engine will make an update to this entity in the future.
  • updated: the automation engine has successfully made an update to this entity.
  • none: No status to set because the org did not have an enabled automation at the time of create/update.
cancellationStatus
string (ShipmentCancellationStatus)
Enum: "pending" "accepted" "rejected"

Shipping request cancellation status

currency
string

Currency code (updating is prohibited if the SR status is in [readyForFulfillment, sentToFulfillment, partialFulfillment, fulfilled, canceled, canceledRestock])

Array of objects (NameValue)

Custom Fields

expectedDeliveryDate
string <date-time>

First Priority to be respected (updating is prohibited if the SR status is in [readyForFulfillment, sentToFulfillment, partialFulfillment, fulfilled, canceled, canceledRestock])

expectedShipDate
string <date-time>

Expected ship date (updating is prohibited if the SR status is in [readyForFulfillment, sentToFulfillment, partialFulfillment, fulfilled, canceled, canceledRestock])

extReferenceId
string

Customer Friendly reference to this shipping request on destination vendor

extReferenceUrl
string

Direct link to this shipping request on destination vendor

extShipmentId
string

Customer Friendly reference to this shipping request on originating vendor, auto generated if not provided

giftNote
string

Shipping Gift note

holdUntil
string or null <date-time>
incoterms
string

International Commercial Terms (updating is prohibited if the SR status is in [readyForFulfillment, sentToFulfillment, partialFulfillment, fulfilled, canceled, canceledRestock])

object (InternalInfo)

Internal info

Array of objects (ShipmentUpdateLineItem)
locationId
string

Id of location defined in organization (can be updated only if the SR is sentToFulfillment already)

overfulfillPolicy
string (OverfulfillPolicy)
Enum: "strict" "report" "approved"

Overfulfill policy

shipAfterDate
string <date-time>

Ship After Date

shipByDate
string <date-time>

Ship By Date (updating is prohibited if the SR status is in [readyForFulfillment, sentToFulfillment, partialFulfillment, fulfilled, canceled, canceledRestock])

shipCancelByDate
string or null <date-time>

Ship Cancel By Date

object (AddressUpdateData)
shippingCarrier
string

Required with ShippingClass, 2nd Priority (updating is prohibited if the SR status is in [readyForFulfillment, sentToFulfillment, partialFulfillment, fulfilled, canceled, canceledRestock])

shippingClass
string

Required with ShippingCarrier, 2nd Priority (updating is prohibited if the SR status is in [readyForFulfillment, sentToFulfillment, partialFulfillment, fulfilled, canceled, canceledRestock])

shippingCode
string

1st Priority (updating is prohibited if the SR status is in [readyForFulfillment, sentToFulfillment, partialFulfillment, fulfilled, canceled, canceledRestock])

shippingLabels
Array of strings

Shipping Labels (updating is prohibited if the SR status is in [readyForFulfillment, sentToFulfillment, partialFulfillment, fulfilled, canceled, canceledRestock])

shippingMethodMapping
boolean

Enable shipping method mapping (defaults to company setting if not provided)

shippingNote
string

Shipping Note (updating is prohibited if the SR status is in [readyForFulfillment, sentToFulfillment, partialFulfillment, fulfilled, canceled, canceledRestock])

shippingPrice
number <float>

Shipping price (updating is prohibited if the SR status is in [readyForFulfillment, sentToFulfillment, partialFulfillment, fulfilled, canceled, canceledRestock])

skipLocation
boolean

A flag to indicate the location in this SR should be skipped during rerun-routing

object (SourceDoc)

Vendor source document

status
string (ShipmentStatus)
Enum: "new" "pendingInventory" "pendingShippingLabel" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "fulfilled" "partialFulfillment" "canceled" "canceledRestock" "failed" "onHold"

Shipping request Status

tags
Array of strings (EntityTags)

Tags assigned to entity

Responses

Request samples

Content type
{
  • "autoEngUpdateStatus": "pending",
  • "cancellationStatus": "pending",
  • "currency": "string",
  • "customFields": [
    ],
  • "expectedDeliveryDate": "2019-08-24T14:15:22Z",
  • "expectedShipDate": "2019-08-24T14:15:22Z",
  • "extReferenceId": "string",
  • "extReferenceUrl": "string",
  • "extShipmentId": "string",
  • "giftNote": "string",
  • "holdUntil": "2019-08-24T14:15:22Z",
  • "incoterms": "string",
  • "internal": {
    },
  • "lineItems": [
    ],
  • "locationId": "string",
  • "overfulfillPolicy": "strict",
  • "shipAfterDate": "2019-08-24T14:15:22Z",
  • "shipByDate": "2019-08-24T14:15:22Z",
  • "shipCancelByDate": "2019-08-24T14:15:22Z",
  • "shippingAddress": {
    },
  • "shippingCarrier": "string",
  • "shippingClass": "string",
  • "shippingCode": "string",
  • "shippingLabels": [
    ],
  • "shippingMethodMapping": true,
  • "shippingNote": "string",
  • "shippingPrice": 0,
  • "skipLocation": true,
  • "sourceDoc": {
    },
  • "status": "new",
  • "tags": [
    ]
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "shipment": {
    }
}

Suppliers

Operations about Suppliers

Supplier Model

required
object (SupplierAddress)
name
required
string

Supplier Name

Array of objects (SupplierContact)
createdAt
string <date-time>

When the object was created within Pipe17

exceptions
Array of strings

References to exceptions related to the supplier

object (InternalInfo)

Internal info

orgKey
string

Organization this object belong to

object (SourceDoc)

Vendor source document

supplierId
string

Supplier ID

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "exceptions": [
    ],
  • "supplierId": "string",
  • "address": {
    },
  • "name": "string",
  • "contacts": [
    ],
  • "internal": {
    },
  • "sourceDoc": {
    },
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Supplier

Uniqueness constraints within organization:

  • supplier.name
Authorizations:
Pipe17KeyAuth
Request Body schema:
required
object (SupplierAddress)
name
required
string

Supplier Name

Array of objects (SupplierContact)
object (InternalInfo)

Internal info

object (SourceDoc)

Vendor source document

Responses

Request samples

Content type
{
  • "address": {
    },
  • "name": "string",
  • "contacts": [
    ],
  • "internal": {
    },
  • "sourceDoc": {
    }
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "supplier": {
    }
}

Delete Multiple Suppliers

Authorizations:
Pipe17KeyAuth
query Parameters
action
string (ListDeleteAction)
Default: "list"
Enum: "list" "soft"

Return the list of what to delete, or delete softly

count
integer <int32>
Default: 100

Delete at most this many suppliers

deleted
boolean

Delete soft deleted suppliers

name
string

Delete suppliers matching name string

orgMode
Array of strings (OrganizationMode)
Items Enum: "sandbox" "production" "internal" "demo"

Delete suppliers assigned these orgModes.

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Delete suppliers created after this date-time

skip
integer <int32>
Default: 0

Skip this many suppliers

supplierId
Array of strings

Delete suppliers by list of supplierId

until
string <date-time>

Delete suppliers created before this date-time

updatedSince
string <date-time>

Delete suppliers updated after this date-time

updatedUntil
string <date-time>

Delete suppliers updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "deleted": 0,
  • "filters": {
    },
  • "pagination": {
    },
  • "suppliers": [
    ]
}

Delete Supplier

Authorizations:
Pipe17KeyAuth
path Parameters
SupplierId
required
string

Supplier ID to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Supplier

Authorizations:
Pipe17KeyAuth
path Parameters
SupplierId
required
string

Supplier ID to fetch

query Parameters
sourceDocVersion
number

Fetch specific vendor source doc version if available

withSourceDoc
boolean

Include vendor source doc if available

withSourceDocVersions
boolean

Include available vendor source doc versions

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "supplier": {
    }
}

List Suppliers

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Return at most this many suppliers

deleted
boolean

Retrieve soft deleted suppliers

exceptionCategoryId
Array of strings

Retrieve suppliers by list of categories of the supplier related exceptions

exceptionType
Array of strings

Retrieve suppliers by list of types of the supplier related exceptions ({exceptionType} | {entityType}_{exceptionType})

hasSourceDoc
boolean

Suppliers containing a source document

keys
string
Default: "supplierId,name,address,contacts,createdAt,updatedAt,orgKey"

Return these top-level fields

name
string

Retrieve suppliers by name (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Suppliers created after this date-time

skip
integer <int32>
Default: 0

Skip this many suppliers

supplierId
Array of strings

Retrieve by list of supplierId

until
string <date-time>

Suppliers created before this date-time

updatedSince
string <date-time>

Suppliers updated after this date-time

updatedUntil
string <date-time>

Suppliers updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "pagination": {
    },
  • "suppliers": [
    ]
}

Sync Suppliers

Trigger the suppliers sync

Authorizations:
Pipe17KeyAuth
path Parameters
SupplierId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Supplier

Uniqueness constraints within organization:

  • supplier.name
Authorizations:
Pipe17KeyAuth
path Parameters
SupplierId
required
string

Supplier ID to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
object (SupplierAddress)
Array of objects (SupplierContact)

Supplier Contacts

object (InternalInfo)

Internal info

name
string

Supplier Name

object (SourceDoc)

Vendor source document

Responses

Request samples

Content type
{
  • "address": {
    },
  • "contacts": [
    ],
  • "internal": {
    },
  • "name": "string",
  • "sourceDoc": {
    }
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "supplier": {
    }
}

Trackings

Operations about Fulfillment Tracking

Tracking Model

fulfillmentId
required
string
shippingCarrier
required
string (ShippingCarrier)
Enum: "ups" "usps" "fedex" "deliverr" "amazon" "other"
trackingNumber
required
string
actualArrivalDate
string <date-time>
actualShipDate
string <date-time>
createdAt
string <date-time>

When the object was created within Pipe17

expectedArrivalDate
string <date-time>
object (InternalInfo)

Internal info

orgKey
string

Organization this object belong to

status
string (TrackingStatus)
Enum: "created" "shipped" "delivered"
trackingId
string
updatedAt
string <date-time>

When the object was updated within Pipe17

url
string
{
  • "actualArrivalDate": "2019-08-24T14:15:22Z",
  • "actualShipDate": "2019-08-24T14:15:22Z",
  • "status": "created",
  • "trackingId": "string",
  • "fulfillmentId": "string",
  • "shippingCarrier": "ups",
  • "trackingNumber": "string",
  • "expectedArrivalDate": "2019-08-24T14:15:22Z",
  • "internal": {
    },
  • "url": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Tracking

Uniqueness constraints within organization:

  • tracking.trackingNumber
Authorizations:
Pipe17KeyAuth
Request Body schema:
fulfillmentId
required
string
shippingCarrier
required
string (ShippingCarrier)
Enum: "ups" "usps" "fedex" "deliverr" "amazon" "other"
trackingNumber
required
string
expectedArrivalDate
string <date-time>
object (InternalInfo)

Internal info

url
string

Responses

Request samples

Content type
{
  • "fulfillmentId": "string",
  • "shippingCarrier": "ups",
  • "trackingNumber": "string",
  • "expectedArrivalDate": "2019-08-24T14:15:22Z",
  • "internal": {
    },
  • "url": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "tracking": {
    }
}

Fetch Tracking

Authorizations:
Pipe17KeyAuth
path Parameters
TrackingId
required
string

Id or ext:{trackingNumber} of tracking to fetch

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "tracking": {
    }
}

List Trackings

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Return at most this many tracking

fulfillmentId
Array of strings
keys
string
Default: "trackingId,trackingNumber,fulfillmentId,shipper,url,actualShipDate,expectedArrivalDate,actualArrivalDate,createdAt,updatedAt,orgKey,status"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

shippingCarrier
Array of strings
since
string <date-time>

Tracking created after this date-time

skip
integer <int32>
Default: 0

Skip this many tracking

status
Array of strings (TrackingStatus)
Items Enum: "created" "shipped" "delivered"
trackingId
Array of strings
trackingNumber
Array of strings
until
string <date-time>

Tracking created before this date-time

updatedSince
string <date-time>

Tracking updated after this date-time

updatedUntil
string <date-time>

Tracking updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "pagination": {
    },
  • "trackings": [
    ]
}

Sync Trackings

Trigger the trackings sync

Authorizations:
Pipe17KeyAuth
path Parameters
TrackingId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Tracking

Uniqueness constraints within organization:

  • tracking.trackingNumber
Authorizations:
Pipe17KeyAuth
path Parameters
TrackingId
required
string

Id or ext:{trackingNumber} of tracking to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
status
required
string
Enum: "shipped" "delivered"
expectedArrivalDate
string <date-time>
object (InternalInfo)

Internal info

Responses

Request samples

Content type
{
  • "status": "shipped",
  • "expectedArrivalDate": "2019-08-24T14:15:22Z",
  • "internal": {
    }
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "tracking": {
    }
}

Transfers

Operations about Transfer Orders

Transfer Model

extOrderId
required
string

External Transfer Order ID

actualArrivalDate
string <date-time>

Actual Arrival Date (from most recent Arrival)

createdAt
string <date-time>

When the object was created within Pipe17

Array of objects (NameValue)

Custom Fields

disableShipmentsReuse
boolean

Hint to whether shipmentId should be re-used, or not

employeeName
string

Transfer order created by

exceptions
Array of strings

References to exceptions related to the transfer

expectedArrivalDate
string <date-time>

Expected Arrival Date

expectedShipDate
string <date-time>

Expected Ship Date

object (TransfersFromLocationAddress)

Shipping Location Address

fromLocationId
string

Shipping Location ID

holdUntil
string <date-time>
incoterms
string

International Commercial Terms

integration
string

Reference to integration that created an item

object (InternalInfo)

Internal info

Array of objects (TransferLineItem)
orderSourceType
string (OrderType)
Enum: "online" "pos" "wholesale" "edi" "other" "b2b"

Order Type (online, pos, etc)

orgKey
string

Organization this object belong to

shipByDate
string <date-time>

Ship By Date

shippingCarrier
string

Shipping Carrier

shippingNotes
string

Shipping Notes

shippingService
string

Shipping Service Type

object (SourceDoc)

Vendor source document

status
string (TransferStatus)
Enum: "draft" "new" "onHold" "toBeValidated" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "partialFulfillment" "fulfilled" "inTransit" "partialReceived" "received" "canceled" "returned" "refunded" "archived" "closed"

Transfer Status

timestamp
string <date-time>

General Purpose Time Stamp

object (Address)
toLocationId
string

Arrival Location ID

transferId
string

Transfer ID

transferNotes
string

Transfer Notes

transferOrderDate
string <date-time>

Transfer Order Date

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "exceptions": [
    ],
  • "fromLocationAddress": {
    },
  • "integration": "string",
  • "transferId": "string",
  • "extOrderId": "string",
  • "actualArrivalDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "disableShipmentsReuse": true,
  • "employeeName": "string",
  • "expectedArrivalDate": "2019-08-24T14:15:22Z",
  • "expectedShipDate": "2019-08-24T14:15:22Z",
  • "fromLocationId": "string",
  • "holdUntil": "2019-08-24T14:15:22Z",
  • "incoterms": "string",
  • "internal": {
    },
  • "lineItems": [
    ],
  • "orderSourceType": "online",
  • "shipByDate": "2019-08-24T14:15:22Z",
  • "shippingCarrier": "string",
  • "shippingNotes": "string",
  • "shippingService": "string",
  • "sourceDoc": {
    },
  • "status": "draft",
  • "timestamp": "2019-08-24T14:15:22Z",
  • "toAddress": {
    },
  • "toLocationId": "string",
  • "transferNotes": "string",
  • "transferOrderDate": "2019-08-24T14:15:22Z",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Transfers

Uniqueness constraints within organization:

  • transfer.extOrderId
Authorizations:
Pipe17KeyAuth
Request Body schema:
Array (<= 10 items)
extOrderId
required
string

External Transfer Order ID

actualArrivalDate
string <date-time>

Actual Arrival Date (from most recent Arrival)

Array of objects (NameValue)

Custom Fields

disableShipmentsReuse
boolean

Hint to whether shipmentId should be re-used, or not

employeeName
string

Transfer order created by

expectedArrivalDate
string <date-time>

Expected Arrival Date

expectedShipDate
string <date-time>

Expected Ship Date

fromLocationId
string

Shipping Location ID

holdUntil
string <date-time>
incoterms
string

International Commercial Terms

object (InternalInfo)

Internal info

Array of objects (TransferLineItem)
orderSourceType
string (OrderType)
Enum: "online" "pos" "wholesale" "edi" "other" "b2b"

Order Type (online, pos, etc)

shipByDate
string <date-time>

Ship By Date

shippingCarrier
string

Shipping Carrier

shippingNotes
string

Shipping Notes

shippingService
string

Shipping Service Type

object (SourceDoc)

Vendor source document

status
string (TransferStatus)
Enum: "draft" "new" "onHold" "toBeValidated" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "partialFulfillment" "fulfilled" "inTransit" "partialReceived" "received" "canceled" "returned" "refunded" "archived" "closed"

Transfer Status

timestamp
string <date-time>

General Purpose Time Stamp

object (Address)
toLocationId
string

Arrival Location ID

transferNotes
string

Transfer Notes

transferOrderDate
string <date-time>

Transfer Order Date

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "transfers": [
    ]
}

Delete Multiple Transfers

Authorizations:
Pipe17KeyAuth
query Parameters
action
string (ListDeleteAction)
Default: "list"
Enum: "list" "soft"

Return the list of what to delete, or delete softly

count
integer <int32>
Default: 100

Delete at most this many transfers

deleted
boolean

Delete soft deleted transfers

extOrderId
Array of strings

Delete transfers by list of external transfer IDs

integration
Array of strings

Delete transfers of these integrations

orderSourceType
Array of strings (OrderType)
Items Enum: "online" "pos" "wholesale" "edi" "other" "b2b"

Delete orders by list of order types

orgMode
Array of strings (OrganizationMode)
Items Enum: "sandbox" "production" "internal" "demo"

Delete transfers assigned these orgModes.

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Delete transfers created after this date-time

skip
integer <int32>
Default: 0

Skip this many transfers

status
Array of strings (TransferStatus)
Items Enum: "draft" "new" "onHold" "toBeValidated" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "partialFulfillment" "fulfilled" "inTransit" "partialReceived" "received" "canceled" "returned" "refunded" "archived" "closed"

Delete transfers by list of statuses

transferId
Array of strings

Delete transfers by list of transferId

until
string <date-time>

Delete transfers created before this date-time

updatedSince
string <date-time>

Delete transfers updated after this date-time

updatedUntil
string <date-time>

Delete transfers updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "deleted": 0,
  • "filters": {
    },
  • "pagination": {
    },
  • "transfers": [
    ]
}

Delete Transfer

Authorizations:
Pipe17KeyAuth
path Parameters
TransferId
required
string

Id or ext:{extOrderId} of transfer to delete

query Parameters
nested
boolean

Delete nested entities

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Transfer

Authorizations:
Pipe17KeyAuth
path Parameters
TransferId
required
string

Id or ext:{extOrderId} of transfer to fetch

query Parameters
sourceDocVersion
number

Fetch specific vendor source doc version if available

withSourceDoc
boolean

Include vendor source doc if available

withSourceDocVersions
boolean

Include available vendor source doc versions

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "transfer": {
    }
}

List Transfers

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Return at most this many transfers

deleted
boolean

Retrieve soft deleted transfers

exceptionCategoryId
Array of strings

Retrieve transfers by list of categories of the transfer related exceptions

exceptionType
Array of strings

Retrieve transfers by list of types of the transfer related exceptions ({exceptionType} | {entityType}_{exceptionType})

extOrderId
Array of strings

Retrieve by list of external transfer IDs

fromLocationId
Array of strings

Retrieve by list of fromLocationId

hasSourceDoc
boolean

Retrieve transfers containing a source document

keys
string
Default: "transferId,extOrderId,status,shipByDate,expectedArrivalDate,createdAt,updatedAt,orgKey"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level fields

orderSourceType
Array of strings (OrderType)
Items Enum: "online" "pos" "wholesale" "edi" "other" "b2b"

Fetch orders by list of types

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Retrieve all transfers created after this date-time

skip
integer <int32>
Default: 0

Skip this many transfers

status
Array of strings (TransferStatus)
Items Enum: "draft" "new" "onHold" "toBeValidated" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "partialFulfillment" "fulfilled" "inTransit" "partialReceived" "received" "canceled" "returned" "refunded" "archived" "closed"

Retrieve by list of statuses

timestamp
boolean

if set to true use timestamp instead of create time

toLocationId
Array of strings

Retrieve by list of toLocationId

transferId
Array of strings

Retrieve by list of transferId

until
string <date-time>

Retrieve all transfers created before this date-time

updatedSince
string <date-time>

Retrieve all transfers updated after this date-time

updatedUntil
string <date-time>

Retrieve all transfers updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "transfers": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Sync Transfers

Trigger the transfers sync

Authorizations:
Pipe17KeyAuth
path Parameters
TransferId
required
Array of strings
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Transfer

Uniqueness constraints within organization:

  • transfer.extOrderId
Authorizations:
Pipe17KeyAuth
path Parameters
TransferId
required
string

Id or ext:{extOrderId} of transfer to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
actualArrivalDate
string or null <date-time>

Actual Arrival Date (from most recent Arrival)

Array of objects (NameValue)

Custom Fields

disableShipmentsReuse
boolean or null

Hint to whether shipmentId should be re-used, or not

employeeName
string or null

Transfer order created by

expectedArrivalDate
string or null <date-time>

Expected Arrival Date

expectedShipDate
string or null <date-time>

Expected Ship Date

fromLocationId
string or null

Shipping Location ID

holdUntil
string or null <date-time>
incoterms
string or null

International Commercial Terms

object (InternalInfo)

Internal info

Array of objects (TransferUpdateLineItem)
orderSourceType
string (OrderType)
Enum: "online" "pos" "wholesale" "edi" "other" "b2b"

Order Type (online, pos, etc)

shipByDate
string or null <date-time>

Ship By Date

shippingCarrier
string or null

Shipping Carrier

shippingNotes
string or null

Shipping Notes

shippingService
string or null

Shipping Service Type

object (SourceDoc)

Vendor source document

status
string (TransferStatus)
Enum: "draft" "new" "onHold" "toBeValidated" "reviewRequired" "readyForFulfillment" "sentToFulfillment" "partialFulfillment" "fulfilled" "inTransit" "partialReceived" "received" "canceled" "returned" "refunded" "archived" "closed"

Transfer Status

timestamp
string or null <date-time>

General Purpose Time Stamp

object or null (AddressNullable)
toLocationId
string or null

Arrival Location ID

transferNotes
string or null

Transfer Notes

Responses

Request samples

Content type
{
  • "actualArrivalDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "disableShipmentsReuse": true,
  • "employeeName": "string",
  • "expectedArrivalDate": "2019-08-24T14:15:22Z",
  • "expectedShipDate": "2019-08-24T14:15:22Z",
  • "fromLocationId": "string",
  • "holdUntil": "2019-08-24T14:15:22Z",
  • "incoterms": "string",
  • "internal": {
    },
  • "lineItems": [
    ],
  • "orderSourceType": "online",
  • "shipByDate": "2019-08-24T14:15:22Z",
  • "shippingCarrier": "string",
  • "shippingNotes": "string",
  • "shippingService": "string",
  • "sourceDoc": {
    },
  • "status": "draft",
  • "timestamp": "2019-08-24T14:15:22Z",
  • "toAddress": {
    },
  • "toLocationId": "string",
  • "transferNotes": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "transfer": {
    }
}

Api Keys

Operations about Api Keys

Api Key Model

allowedIPs
required
Array of strings

IP/CIDR Whitelist

required
object (Methods)

Access Methods Allowed

name
required
string

API Key Name

apikeyId
string

API key Id

connector
string

Connector ID

createdAt
string <date-time>

When the object was created within Pipe17

description
string

API Key Description

environment
string (Env)
Enum: "test" "prod"

Environment ID

integration
string

Integration ID

object (InternalInfo)

Internal info

orgKey
string

Organization this object belong to

tier
string (Tier)
Enum: "free" "basic" "enterprise"

Tier (usage plan)

type
string
Enum: "regular" "temporary"

API Key type (default - regular)

updatedAt
string <date-time>

When the object was updated within Pipe17

userId
string

User ID of the key creator, if known

{
  • "apikeyId": "string",
  • "userId": "string",
  • "allowedIPs": [
    ],
  • "methods": {
    },
  • "name": "string",
  • "connector": "string",
  • "description": "string",
  • "environment": "test",
  • "integration": "string",
  • "internal": {
    },
  • "tier": "free",
  • "type": "regular",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create API Key

Authorizations:
Pipe17KeyAuth
Request Body schema:
allowedIPs
required
Array of strings

IP/CIDR Whitelist

required
object (Methods)

Access Methods Allowed

name
required
string

API Key Name

connector
string

Connector ID

description
string

API Key Description

environment
string (Env)
Enum: "test" "prod"

Environment ID

integration
string

Integration ID

object (InternalInfo)

Internal info

tier
string (Tier)
Enum: "free" "basic" "enterprise"

Tier (usage plan)

type
string
Enum: "regular" "temporary"

API Key type (default - regular)

Responses

Request samples

Content type
{
  • "allowedIPs": [
    ],
  • "methods": {
    },
  • "name": "string",
  • "connector": "string",
  • "description": "string",
  • "environment": "test",
  • "integration": "string",
  • "internal": {
    },
  • "tier": "free",
  • "type": "regular"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "apikey": "string",
  • "apikeyId": "string"
}

Fetch API Key

Authorizations:
Pipe17KeyAuth
path Parameters
ApiKey
required
string

Value or ID of API key to fetch

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "apikey": {
    }
}

Fetch API Key Info, including the key value

Authorizations:
Pipe17KeyAuth
path Parameters
ApiKey
required
string

Value or ID of API key to fetch

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "apikey": {
    }
}

List API Keys

Authorizations:
Pipe17KeyAuth
query Parameters
apikeyId
Array of strings

API Keys by list of apikey ids

connector
Array of strings

List API Keys matching to provided connector id(s)

count
integer <int32>
Default: 100

Return at most this many API Keys

integration
Array of strings

List API Keys matching to provided integration id(s)

keys
string
Default: "apikeyId,name,description,integration,connector,tier,environment,methods,allowedIPs,createdAt,updatedAt,orgKey"

Return these top-level fields

name
string

List API Keys matching to provided name(s)

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

List API Keys created after this date-time

skip
integer <int32>
Default: 0

Skip this many API Keys

type
string
Enum: "regular" "temporary"

List API Keys of this type (default - all)

until
string <date-time>

List API Keys created before this date-time

updatedSince
string <date-time>

List API Keys updated after this date-time

updatedUntil
string <date-time>

List API Keys updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "apikeys": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Update API Key

Authorizations:
Pipe17KeyAuth
path Parameters
ApiKey
required
string

Value or ID of API key to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
allowedIPs
Array of strings

IP/CIDR Whitelist

description
string

API Key Description

object (InternalInfo)

Internal info

object (MethodsUpdateData)

Access Methods Allowed

name
string

API Key Name

tier
string

Usage plan

Responses

Request samples

Content type
{
  • "allowedIPs": [
    ],
  • "description": "string",
  • "internal": {
    },
  • "methods": {
    },
  • "name": "string",
  • "tier": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "apikey": {
    }
}

Automation Rules

Operations around Automation Rules. An automation rule contains filters and actions that determine when and how to execute automation actions. An automation rule always belongs to an automation.

Automation Rule Model

automationId
required
string (AutomationRuleAutomationId)

The ID of the parent automation

required
object (AutomationRuleFilter)

Determines whether or not the automation rule is applied to the entity.

name
required
string (AutomationRuleName)

The name of the automation rule. Must be unique within the automation.

Array of objects (AutomationRuleActions)

The actions to be performed by the automation rule. An automation rule must contain at least one action.

assessmentOrder
integer >= -1

The order that the automation rule gets assessed. The default rule's order will be -1.

automationRuleId
string

The unique identifier of the automation rule

createdAt
string <date-time>

When the object was created within Pipe17

createdBy
string

ID of the user who created the automation rule

description
string (AutomationRuleDescription)

The description of the automation rule. A good place to note a rule's when, where and why.

object (InternalInfo)

Internal info

isDefault
boolean (AutomationRuleIsDefault)
Default: false

Whether or not this is the default rule for the automation. There can only be one default rule within an automation rule and it must be enabled. The default automation rule is something that's managed by the platform and will always execute last if no other rules that terminate the automation run are applied.

isEnabled
boolean (AutomationRuleIsEnabled)
Default: true

Whether the automation rule is enabled or not. Disabled rules will not be assesesed when their parent automation is triggered.

orgKey
string

Organization this object belong to

updatedAt
string <date-time>

When the object was updated within Pipe17

updatedBy
string

ID of the user who last updated the automation rule

{
  • "assessmentOrder": -1,
  • "automationRuleId": "string",
  • "createdBy": "string",
  • "updatedBy": "string",
  • "automationId": "string",
  • "filter": {
    },
  • "name": "string",
  • "actions": [
    ],
  • "description": "string",
  • "internal": {
    },
  • "isDefault": false,
  • "isEnabled": true,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Automation Rule

Uniqueness constraints:

  • automationId + name
Authorizations:
Pipe17KeyAuth
Request Body schema:
automationId
required
string (AutomationRuleAutomationId)

The ID of the parent automation

required
object (AutomationRuleFilter)

Determines whether or not the automation rule is applied to the entity.

name
required
string (AutomationRuleName)

The name of the automation rule. Must be unique within the automation.

Array of objects (AutomationRuleActions)

The actions to be performed by the automation rule. An automation rule must contain at least one action.

description
string (AutomationRuleDescription)

The description of the automation rule. A good place to note a rule's when, where and why.

object (InternalInfo)

Internal info

isDefault
boolean (AutomationRuleIsDefault)
Default: false

Whether or not this is the default rule for the automation. There can only be one default rule within an automation rule and it must be enabled. The default automation rule is something that's managed by the platform and will always execute last if no other rules that terminate the automation run are applied.

isEnabled
boolean (AutomationRuleIsEnabled)
Default: true

Whether the automation rule is enabled or not. Disabled rules will not be assesesed when their parent automation is triggered.

Responses

Request samples

Content type
{
  • "automationId": "string",
  • "filter": {
    },
  • "name": "string",
  • "actions": [
    ],
  • "description": "string",
  • "internal": {
    },
  • "isDefault": false,
  • "isEnabled": true
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "automationRule": {
    }
}

Delete Automation Rule

Authorizations:
Pipe17KeyAuth
path Parameters
AutomationRuleId
required
string

Id of the Automation Rule to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Automation Rule

Authorizations:
Pipe17KeyAuth
path Parameters
AutomationRuleId
required
string

Id of the automation rule to fetch

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "automationRule": {
    }
}

List Automation Rules

Authorizations:
Pipe17KeyAuth
query Parameters
automationId
Array of strings (AutomationRulesListFilterAutomationId)

Filter by list of automationIds

automationRuleId
Array of strings (AutomationRulesListFilterAutomationRuleId)

Filter by list of automationRuleIds

count
integer <int32>
Default: 100

Max number of items to return

deleted
boolean

Whether to retrieve soft deleted items

isDefault
boolean

Filter by isDefault

isEnabled
boolean

Filter by isEnabled

keys
string
Default: "automationId,automationRuleId,isEnabled,createdAt,updatedAt,orgKey,assessmentOrder,name,description,isDefault"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level field

orgKey
string

Organization key

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Select items created after this date-time

skip
integer <int32>
Default: 0

Number of items to skip

until
string <date-time>

Select items created before this date-time

updatedSince
string <date-time>

Select items updated after this date-time

updatedUntil
string <date-time>

Select items updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "automationRules": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Update Automation Rule

Authorizations:
Pipe17KeyAuth
path Parameters
AutomationRuleId
required
string

Id of the automation rule to update

Request Body schema:
Array of objects (AutomationRuleActions)

The actions to be performed by the automation rule. An automation rule must contain at least one action.

description
string (AutomationRuleDescription)

The description of the automation rule. A good place to note a rule's when, where and why.

object (AutomationRuleFilter)

Determines whether or not the automation rule is applied to the entity.

object (InternalInfo)

Internal info

isEnabled
boolean (AutomationRuleIsEnabled)
Default: true

Whether the automation rule is enabled or not. Disabled rules will not be assesesed when their parent automation is triggered.

name
string (AutomationRuleName)

The name of the automation rule. Must be unique within the automation.

Responses

Request samples

Content type
{
  • "actions": [
    ],
  • "description": "string",
  • "filter": {
    },
  • "internal": {
    },
  • "isEnabled": true,
  • "name": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Automation Runs

Operations around Automation Runs. An automation run captures the history of an automation being executed on an entity.

Automation Run Model

automationId
required
string

The type of the entity being operated on

automationRunId
required
string

The unique identifier of the automation.

entityId
required
string

The id of the entity being operated on

entityType
required
string
Enum: "orders" "shipments" "fulfillments" "exceptions"
status
required
string
Enum: "IN_PROGRESS" "FAILED" "COMPLETED"

Status of the automation run

Array of objects (AutomationRunAction)

Required. The actions that were planned out for the automation run.

automationRuleIds
Array of strings

IDs of the automation rules that matched the filter and had actions that were used. Some rules may have a passing filter but won't be used if a preceding rule had a terminal action. In this case, those rule ids should not be included in this array.

completedAt
string <date-time>

The time the automation run was completed

createdAt
string <date-time>

When the object was created within Pipe17

errorMessage
string

The error message if the automation run failed

execCount
integer (AutomationRunExecCount) >= 1

The number of times the automation run has been executed. If a job fails and is retried, this number will increase.

failedAt
string <date-time>

The time the automation run failed

object (InternalInfo)

Internal info

orgKey
string

Organization this object belong to

Array of objects (AutomationStep)

Required. The steps that were planned out for the automation run.

trigger
string
Enum: "event" "manual"

event: (default) The run was created due to an event that triggered the automation manual: The run was manually created by an user

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "automationRunId": "string",
  • "status": "IN_PROGRESS",
  • "execCount": 1,
  • "automationId": "string",
  • "entityId": "string",
  • "entityType": "orders",
  • "actions": [
    ],
  • "automationRuleIds": [
    ],
  • "completedAt": "2019-08-24T14:15:22Z",
  • "errorMessage": "string",
  • "failedAt": "2019-08-24T14:15:22Z",
  • "internal": {
    },
  • "steps": [
    ],
  • "trigger": "event",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create AutomationRun

Authorizations:
Pipe17KeyAuth
Request Body schema:
automationId
required
string

The type of the entity being operated on

entityId
required
string

The id of the entity being operated on

entityType
required
string
Enum: "orders" "shipments" "fulfillments" "exceptions"
Array of objects (AutomationRunAction)

Required. The actions that were planned out for the automation run.

automationRuleIds
Array of strings

IDs of the automation rules that matched the filter and had actions that were used. Some rules may have a passing filter but won't be used if a preceding rule had a terminal action. In this case, those rule ids should not be included in this array.

completedAt
string <date-time>

The time the automation run was completed

errorMessage
string

The error message if the automation run failed

failedAt
string <date-time>

The time the automation run failed

object (InternalInfo)

Internal info

status
string (AutomationRunStatus)
Enum: "IN_PROGRESS" "FAILED" "COMPLETED"
Array of objects (AutomationStep)

Required. The steps that were planned out for the automation run.

trigger
string
Enum: "event" "manual"

event: (default) The run was created due to an event that triggered the automation manual: The run was manually created by an user

Responses

Request samples

Content type
{
  • "automationId": "string",
  • "entityId": "string",
  • "entityType": "orders",
  • "actions": [
    ],
  • "automationRuleIds": [
    ],
  • "completedAt": "2019-08-24T14:15:22Z",
  • "errorMessage": "string",
  • "failedAt": "2019-08-24T14:15:22Z",
  • "internal": {
    },
  • "status": "IN_PROGRESS",
  • "steps": [
    ],
  • "trigger": "event"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "automationRun": {
    }
}

Delete Automation Run

Authorizations:
Pipe17KeyAuth
path Parameters
AutomationRunId
required
string

Id of the Automation Run to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Automation Run

Authorizations:
Pipe17KeyAuth
path Parameters
AutomationRunId
required
string

Id of the automation run

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "automationRun": {
    }
}

List Automation Runs

Authorizations:
Pipe17KeyAuth
query Parameters
automationId
Array of strings (AutomationRunsListFilterAutomationId)

Filter by list of automationIds

automationRunId
Array of strings (AutomationRunsListFilterAutomationRunId)

Filter by list of automationRunIds

count
integer <int32>
Default: 100

Max number of items to return

deleted
boolean

Whether to retrieve soft deleted items

entityId
Array of strings (AutomationRunsListFilterEntityId)

Filter by list of entityIds

keys
string
Default: "orgKey,automationId,automationRunId,entityId,orgKey,createdAt,updatedAt,status,completedAt,failedAt,errorMessage,trigger"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level field

orgKey
string

Organization key

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Select items created after this date-time

skip
integer <int32>
Default: 0

Number of items to skip

status
Array of strings (AutomationRunsListFilterStatus)

Filter by automation run status

until
string <date-time>

Select items created before this date-time

updatedSince
string <date-time>

Select items updated after this date-time

updatedUntil
string <date-time>

Select items updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "automationRuns": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Update Automation Run

Authorizations:
Pipe17KeyAuth
path Parameters
AutomationRunId
required
string

Id of the automation run to update

Request Body schema:
automationRuleIds
Array of strings

IDs of the automation rules that matched the filter and had actions that were used. Some rules may have a passing filter but won't be used if a preceding rule had a terminal action. In this case, those rule ids should not be included in this array.

completedAt
string <date-time>

The time the automation run was completed

errorMessage
string

The error message if the automation run failed

execCount
integer (AutomationRunExecCount) >= 1

The number of times the automation run has been executed. If a job fails and is retried, this number will increase.

failedAt
string <date-time>

The time the automation run failed

object (InternalInfo)

Internal info

status
string (AutomationRunStatus)
Enum: "IN_PROGRESS" "FAILED" "COMPLETED"
Array of objects (AutomationStep)

The steps that the automation run will take.

Responses

Request samples

Content type
{
  • "automationRuleIds": [
    ],
  • "completedAt": "2019-08-24T14:15:22Z",
  • "errorMessage": "string",
  • "execCount": 1,
  • "failedAt": "2019-08-24T14:15:22Z",
  • "internal": {
    },
  • "status": "IN_PROGRESS",
  • "steps": [
    ]
}

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Automations

Operations around Automations. An automation is the highest level entity of the Automation Engine.

Automation Model

trigger
required
string (AutomationTrigger)
Enum: "NEW_ORDER" "ORDER_UPDATED" "SHIPMENT_UPDATED" "FULFILLMENT_CREATED" "MANUAL_ORDER" "MANUAL_SHIPMENT" "MANUAL_FULFILLMENT" "EXCEPTION_MODIFIED"

The name of the event that starts the automation.

automationId
string

The unique identifier of the automation.

createdAt
string <date-time>

When the object was created within Pipe17

object (InternalInfo)

Internal info

isEnabled
boolean
Default: true

Whether the automation is enabled or not.

orgKey
string

Organization this object belong to

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "automationId": "string",
  • "trigger": "NEW_ORDER",
  • "internal": {
    },
  • "isEnabled": true,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Automation

Uniqueness constraints:

  • automation.trigger
Authorizations:
Pipe17KeyAuth
Request Body schema:
trigger
required
string (AutomationTrigger)
Enum: "NEW_ORDER" "ORDER_UPDATED" "SHIPMENT_UPDATED" "FULFILLMENT_CREATED" "MANUAL_ORDER" "MANUAL_SHIPMENT" "MANUAL_FULFILLMENT" "EXCEPTION_MODIFIED"

The name of the event that starts the automation.

object (InternalInfo)

Internal info

isEnabled
boolean
Default: true

Whether the automation is enabled or not.

Responses

Request samples

Content type
{
  • "trigger": "NEW_ORDER",
  • "internal": {
    },
  • "isEnabled": true
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "automation": {
    }
}

Delete Automation

Authorizations:
Pipe17KeyAuth
path Parameters
AutomationId
required
string

Automation Id to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Automation

Authorizations:
Pipe17KeyAuth
path Parameters
AutomationId
required
string

Id of the automation to fetch

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "automation": {
    }
}

List Automations

Authorizations:
Pipe17KeyAuth
query Parameters
automationId
Array of strings (AutomationsListFilterAutomationId)

Filter by list of automationId

count
integer <int32>
Default: 100

Max number of items to return

deleted
boolean

Whether to retrieve soft deleted items

isEnabled
boolean
keys
string
Default: "automationId,isEnabled,trigger,createdAt,updatedAt,orgKey"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level field

orgKey
string

Organization key

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Select items created after this date-time

skip
integer <int32>
Default: 0

Number of items to skip

trigger
Array of strings (AutomationsListFilterTrigger)
Items Enum: "NEW_ORDER" "ORDER_UPDATED" "SHIPMENT_UPDATED" "FULFILLMENT_CREATED" "MANUAL_ORDER" "MANUAL_SHIPMENT" "MANUAL_FULFILLMENT" "EXCEPTION_MODIFIED"

Filter by matching trigger

until
string <date-time>

Select items created before this date-time

updatedSince
string <date-time>

Select items updated after this date-time

updatedUntil
string <date-time>

Select items updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "automations": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Set Automation Rule Assessment Order

Authorizations:
Pipe17KeyAuth
path Parameters
AutomationId
required
string

Automation Id to update

Request Body schema:
automationRuleIds
Array of strings

List of automation rule ids in the order they should be evaluated. Must include all automation rule ids for the automation, excluding that of the default automation rule.

Responses

Request samples

Content type
{
  • "automationRuleIds": [
    ]
}

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Automation

Authorizations:
Pipe17KeyAuth
path Parameters
AutomationId
required
string

Automation Id to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
object (InternalInfo)

Internal info

isEnabled
boolean

Whether the automation is enabled or not.

Responses

Request samples

Content type
{
  • "internal": {
    },
  • "isEnabled": true
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "automation": {
    }
}

Connectors

Operations about Connectors

Connector Model

connectorName
required
string

Connector Name

connectorType
required
string (ConnectorType)
Enum: "ecommerce" "finance" "logistics" "plugin" "other"

Connector Type

Array of objects (ConnectorAction)

List of actions supported by connector

availabilityStatus
string (ConnectorAvailabilityStatus)
Enum: "general" "limited" "future" "beta" "deprecated"

Connector availability status

capability
Array of strings
Items Enum: "arrivals:in" "arrivals:out" "customers:in" "customers:out" "contacts:in" "contacts:out" "fulfillments:in" "fulfillments:out" "inventory:in" "inventory:out" "labels:in" "labels:out" "locations:in" "locations:out" "orders:in" "orders:out" "products:in" "products:out" "purchases:in" "purchases:out" "receipts:in" "receipts:out" "refunds:in" "refunds:out" "returns:in" "returns:out" "shipments:in" "shipments:out" "suppliers:in" "suppliers:out" "transfers:in" "transfers:out" "shipping_methods" "sku_mapping" "shipments_cancel_in" "shipments_cancel_out" "events_outbound_replay" "events_outbound_batch" "inventory_requires_products" "orders_cancel_in" "orders_cancel_out" "inventory_incremental" "locations_multiple" "orders_multiple_destinations"
object (ConnectorConnection)

3rd party's credentials

connectorId
string

Connector ID

createdAt
string <date-time>

When the object was created within Pipe17

description
string

Connector description

disableAutoProvision
boolean

Disables plugin connector from being auto-provisioned to new orgs

displayName
string

Connector Display Name

Array of objects (ConnectorEntity)
intentName
string

Connector intent label

intentRank
number

Connector intent rank (higher ranks indicate better match)

intentShow
boolean

Indicates whether to show connector on intent

object (InternalInfo)

Internal info

isPublic
boolean

Public connector indicator

linkedConnectorId
string

Link connector with parent connectorId to allow parent accessing all integrations of this connector

linkedConnectorName
string

Link connector with parent by name to allow parent accessing all integrations of this connector

logoUrl
string

Logo URL

orgKey
string

Organization this object belong to

orgUnique
boolean

Indicates whether only one integration is allowed to be created in org

orgWideAccess
boolean

Indicates whether connector/integration should have access to all declared entity types

pricingCategory
string

Connector pricing category

rank
number

Connector rank in category (higher ranks indicate better match)

readme
string

Connector readme markup

selfServiceMode
string (ConnectorSelfServiceMode)
Enum: "full" "assisted" "disabled"

Connector self service mode status

object (ConnectorSettings)

Connector specific settings

slug
string

Connector Slug

status
string (ConnectorStatus)
Enum: "created" "active" "inactive" "deleted"

Connector Status

tags
Array of strings (EntityTags)

Tags assigned to entity

updatedAt
string <date-time>

When the object was updated within Pipe17

version
string

Connector version

object (ConnectorWebhook)
{
  • "availabilityStatus": "general",
  • "capability": [
    ],
  • "connectorId": "string",
  • "disableAutoProvision": true,
  • "intentName": "string",
  • "intentRank": 0,
  • "intentShow": true,
  • "isPublic": true,
  • "rank": 0,
  • "selfServiceMode": "full",
  • "status": "created",
  • "connectorName": "string",
  • "connectorType": "ecommerce",
  • "actions": [
    ],
  • "connection": {
    },
  • "description": "string",
  • "displayName": "string",
  • "entities": [
    ],
  • "internal": {
    },
  • "linkedConnectorId": "string",
  • "linkedConnectorName": "string",
  • "logoUrl": "string",
  • "orgUnique": true,
  • "orgWideAccess": true,
  • "pricingCategory": "string",
  • "readme": "string",
  • "settings": {
    },
  • "slug": "string",
  • "tags": [
    ],
  • "version": "string",
  • "webhook": {
    },
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Connector

Uniqueness constraints:

  • connector.connectorName
Authorizations:
Pipe17KeyAuth
Request Body schema:
connectorName
required
string

Connector Name

connectorType
required
string (ConnectorType)
Enum: "ecommerce" "finance" "logistics" "plugin" "other"

Connector Type

Array of objects (ConnectorAction)

List of actions supported by connector

capability
Array of strings
object (ConnectorConnection)

3rd party's credentials

description
string

Connector description

displayName
string

Connector Display Name

Array of objects (ConnectorEntity)
object (InternalInfo)

Internal info

linkedConnectorId
string

Link connector with parent connectorId to allow parent accessing all integrations of this connector

linkedConnectorName
string

Link connector with parent by name to allow parent accessing all integrations of this connector

logoUrl
string

Logo URL

orgUnique
boolean

Indicates whether only one integration is allowed to be created in org

orgWideAccess
boolean

Indicates whether connector/integration should have access to all declared entity types

pricingCategory
string

Connector pricing category

readme
string

Connector readme markup

object (ConnectorSettings)

Connector specific settings

slug
string

Connector Slug

tags
Array of strings (EntityTags)

Tags assigned to entity

version
string

Connector version

object (ConnectorWebhook)

Responses

Request samples

Content type
{
  • "connectorName": "string",
  • "connectorType": "ecommerce",
  • "actions": [
    ],
  • "capability": [
    ],
  • "connection": {
    },
  • "description": "string",
  • "displayName": "string",
  • "entities": [
    ],
  • "internal": {
    },
  • "linkedConnectorId": "string",
  • "linkedConnectorName": "string",
  • "logoUrl": "string",
  • "orgUnique": true,
  • "orgWideAccess": true,
  • "pricingCategory": "string",
  • "readme": "string",
  • "settings": {
    },
  • "slug": "string",
  • "tags": [
    ],
  • "version": "string",
  • "webhook": {
    }
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "connector": {
    }
}

Delete Connector

Authorizations:
Pipe17KeyAuth
path Parameters
ConnectorId
required
string

Connector Id to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Connector

Authorizations:
Pipe17KeyAuth
path Parameters
ConnectorId
required
string

Connector Id to fetch

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "connector": {
    }
}

List Connectors

Authorizations:
Pipe17KeyAuth
query Parameters
availabilityStatus
Array of strings (ConnectorAvailabilityStatus)
Items Enum: "general" "limited" "future" "beta" "deprecated"

Retrieve connectors by list of availability statuses

capability
Array of strings

Retrieve connectors by list of capabilities

connectorId
Array of strings

Retrieve connectors by list of connectorId

connectorName
Array of strings

Retrieve connectors by list of connector names

connectorType
Array of strings (ConnectorType)
Items Enum: "ecommerce" "finance" "logistics" "plugin" "other"
count
integer <int32>
Default: 100

Return at most this many connectors

intentShow
boolean

Retrieve connectors by intentShow attribute

keys
string
Default: "displayName,description,version,connectorId,status,connectorName,connectorType,logoUrl,entities,settings,connection,createdAt,updatedAt,orgKey,tags"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

selfServiceMode
Array of strings (ConnectorSelfServiceMode)
Items Enum: "full" "assisted" "disabled"

Retrieve connectors by list of self-service modes

since
string <date-time>

Connectors created after this date-time

skip
integer <int32>
Default: 0

Skip this many connectors

slug
Array of strings

Retrieve connectors by list of connector slugs

tags
Array of strings (EntityTags)

Tags assigned to entity

until
string <date-time>

Connectors created before this date-time

updatedSince
string <date-time>

Connectors updated after this date-time

updatedUntil
string <date-time>

Connectors updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "connectors": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Update Connector

Uniqueness constraints:

  • connector.connectorName
Authorizations:
Pipe17KeyAuth
path Parameters
ConnectorId
required
string

Connector Id to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
Array of objects or null (ConnectorAction)

List of actions supported by connector

capability
Array of strings or null
object (ConnectorConnection)

3rd party's credentials

connectorType
string (ConnectorType)
Enum: "ecommerce" "finance" "logistics" "plugin" "other"

Connector Type

description
string

Connector description

displayName
string

Connector Display Name

Array of objects (ConnectorEntity)
object (InternalInfo)

Internal info

linkedConnectorId
string or null

Link connector with parent connectorId to allow parent accessing all integrations of this connector

linkedConnectorName
string or null

Link connector with parent by name to allow parent accessing all integrations of this connector

logoUrl
string or null

Logo URL

orgUnique
boolean

Indicates whether only one integration is allowed to be created in org

orgWideAccess
boolean

Indicates whether connector/integration should have access to all declared entity types

pricingCategory
string

Connector pricing category

readme
string

Connector readme markup

object (ConnectorSettings)

Connector specific settings

slug
string

Connector Slug

status
string
Enum: "active" "inactive"

Connector Status

tags
Array of strings (EntityTags)

Tags assigned to entity

version
string

Connector version

object or null

Connector Webhook

Responses

Request samples

Content type
{
  • "actions": [
    ],
  • "capability": [
    ],
  • "connection": {
    },
  • "connectorType": "ecommerce",
  • "description": "string",
  • "displayName": "string",
  • "entities": [
    ],
  • "internal": {
    },
  • "linkedConnectorId": "string",
  • "linkedConnectorName": "string",
  • "logoUrl": "string",
  • "orgUnique": true,
  • "orgWideAccess": true,
  • "pricingCategory": "string",
  • "readme": "string",
  • "settings": {
    },
  • "slug": "string",
  • "status": "active",
  • "tags": [
    ],
  • "version": "string",
  • "webhook": {
    }
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "connector": {
    }
}

Event Log

Operations on Event Log

Event Model

createdAt
string <date-time>

When the object was created within Pipe17

direction
string (Direction)
Enum: "in" "out"

Route/Mapping Direction

duration
number <int32>

operation duration

entityId
string

entityId

entityType
string

entity type

eventId
string

Event ID

extEntityId
string

extEntityId

integration
string

integration id

isBatch
boolean

Indicates if the event is for a batch action

keywords
Array of strings
operation
string (EventOperation)
Enum: "create" "update" "delete" "poll" "acknowledge" "check" "cleanup" "detach" "download" "mode" "move" "reinvite" "replay" "reset_password" "results" "set-rule-order" "setup" "sync" "upgrade" "upload" "variables"

Name of operation with entity. The following operations are applicable only to particular types of entities:

  • "acknowledge" - fulfillments
  • "check" - orders
  • "cleanup" - organizations
  • "detach" - organizations
  • "download" - labels
  • "mode" - organizations
  • "move" - organizations
  • "reinvite" - users
  • "replay" - events
  • "reset_password" - users
  • "results" - jobs
  • "set-rule-order" - automations
  • "setup" - connectors
  • "sync" - arrivals, fulfillments, inventory, orders, products, receipts, shipments
  • "upgrade" - integrations
  • "upload" - labels
  • "variables" - integrations
orgKey
string

Organization this object belong to

object (EventRequestData)
requestId
string

API request Id

object (EventResponseData)
source
string
Enum: "custom" "api" "api-webhook"

Event Type

status
string (EventRequestStatus)
Enum: "pending" "acknowledged" "completed" "failed"

Event Status

timestamp
string <date-time>

When the event was triggered

updatedAt
string <date-time>

When the object was updated within Pipe17

userId
string

API user id

{
  • "eventId": "string",
  • "keywords": [
    ],
  • "source": "custom",
  • "direction": "in",
  • "duration": 0,
  • "entityId": "string",
  • "entityType": "string",
  • "extEntityId": "string",
  • "integration": "string",
  • "isBatch": true,
  • "operation": "create",
  • "request": {
    },
  • "requestId": "string",
  • "response": {
    },
  • "status": "pending",
  • "timestamp": "2019-08-24T14:15:22Z",
  • "userId": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create event

Authorizations:
Pipe17KeyAuth
Request Body schema:
direction
string (Direction)
Enum: "in" "out"

Route/Mapping Direction

duration
number <int32>

operation duration

entityId
string

entityId

entityType
string

entity type

extEntityId
string

extEntityId

integration
string

integration id

isBatch
boolean

Indicates if the event is for a batch action

operation
string (EventOperation)
Enum: "create" "update" "delete" "poll" "acknowledge" "check" "cleanup" "detach" "download" "mode" "move" "reinvite" "replay" "reset_password" "results" "set-rule-order" "setup" "sync" "upgrade" "upload" "variables"

Name of operation with entity. The following operations are applicable only to particular types of entities:

  • "acknowledge" - fulfillments
  • "check" - orders
  • "cleanup" - organizations
  • "detach" - organizations
  • "download" - labels
  • "mode" - organizations
  • "move" - organizations
  • "reinvite" - users
  • "replay" - events
  • "reset_password" - users
  • "results" - jobs
  • "set-rule-order" - automations
  • "setup" - connectors
  • "sync" - arrivals, fulfillments, inventory, orders, products, receipts, shipments
  • "upgrade" - integrations
  • "upload" - labels
  • "variables" - integrations
object (EventRequestData)
requestId
string

API request Id

object (EventResponseData)
source
string (EventRequestSourcePublic)
Value: "custom"

Event Type

status
string (EventRequestStatus)
Enum: "pending" "acknowledged" "completed" "failed"

Event Status

timestamp
string <date-time>

When the event was triggered

userId
string

API user id

Responses

Request samples

Content type
{
  • "direction": "in",
  • "duration": 0,
  • "entityId": "string",
  • "entityType": "string",
  • "extEntityId": "string",
  • "integration": "string",
  • "isBatch": true,
  • "operation": "create",
  • "request": {
    },
  • "requestId": "string",
  • "response": {
    },
  • "source": "custom",
  • "status": "pending",
  • "timestamp": "2019-08-24T14:15:22Z",
  • "userId": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "event": {
    }
}

Fetch Event

Authorizations:
Pipe17KeyAuth
path Parameters
EventId
required
string

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "event": {
    }
}

List Events

Authorizations:
Pipe17KeyAuth
query Parameters
apikeyId
Array of strings

Fetch by list of api keys

count
integer <int32>
Default: 100

Max number of events to return

direction
Array of strings (Direction)
Items Enum: "in" "out"

Fetch by list of direction

entityId
Array of strings

Fetch by list of entityId

entityType
Array of strings

Fetch by list of entity types

eventId
Array of strings

Fetch by list of eventId

extEntityId
Array of strings

Fetch by list of extEntityId

identity
Array of strings

Fetch by identity ids (- either integration, apikeyId, or userId)

integration
Array of strings

Fetch by list of integrations

keys
string
Default: "eventId,source,status,operation,direction,entityType,entityId,integration,extEntityId,requestId,userId,createdAt,updatedAt,orgKey"

Return these top-level fields

keywords
Array of strings

Fetch by keywords

operation
Array of strings (EventOperation)
Items Enum: "create" "update" "delete" "poll" "acknowledge" "check" "cleanup" "detach" "download" "mode" "move" "reinvite" "replay" "reset_password" "results" "set-rule-order" "setup" "sync" "upgrade" "upload" "variables"

Fetch by list of operation types

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Fetch events triggered after this date-time

skip
integer <int32>
Default: 0

Number of events to skip

source
Array of strings (EventRequestSource)
Items Enum: "api" "api-webhook" "custom"

Fetch by list of event sources

status
Array of strings (EventRequestStatus)
Items Enum: "pending" "acknowledged" "completed" "failed"

Fetch by list of event statuses

until
string <date-time>

Fetch events triggered before this date-time

userId
Array of strings

Fetch by list of userId

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "events": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Replay event entry

Authorizations:
Pipe17KeyAuth
path Parameters
EventId
required
string

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update event entry

Authorizations:
Pipe17KeyAuth
path Parameters
EventId
required
string
query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
duration
number <int32>

operation duration

isBatch
boolean

Indicates if the event is for a batch action

object (EventResponseData)
status
string (EventRequestStatus)
Enum: "pending" "acknowledged" "completed" "failed"

Event Status

Responses

Request samples

Content type
{
  • "duration": 0,
  • "isBatch": true,
  • "response": {
    },
  • "status": "pending"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "event": {
    }
}

Exceptions

Operations on Exceptions

Exception Model

entityId
required
string

Entity ID

entityType
required
string (ExceptionEntityName)
Enum: "accounts" "apikey" "arrivals" "automation_rules" "automation_runs" "automations" "changelog" "connectors" "customers" "contacts" "entity_filters" "entity_schemas" "events" "exception_categories" "exception_filters" "exceptions" "fulfillments" "functions" "integration_actions" "integration_state" "integrations" "inventory" "inventoryrules" "invoices" "jobs" "labels" "locations" "lookup_objects" "mappings" "notes" "order_routing_runs" "order_routings" "orders" "organizations" "catalogs" "catalog_products" "pricing" "products" "purchases" "receipts" "references" "refunds" "returns" "roles" "routings" "shipment_boxes" "shipments" "shipping_methods" "statement_transactions" "statements" "suppliers" "trackings" "transfers" "usagedata" "usageplans" "users" "vendor_schemas" "webhooks"

Exception Entity Name

exceptionType
required
string (ExceptionType)
Enum: "eAutomation" "eAutomationCodeFilterError" "eAutomationCodeActionError" "eGeneric" "eSyncFailure" "eUnacknowledged" "eDelayed" "eLate" "eLateCancel" "eEarly" "eLost" "eToday" "eSplit" "eStuck" "eLarge" "eLow" "eMissing" "eMissingSKU" "eMissingLocation" "eMismatch" "eMismatchTax" "eInvalid" "eInvalidAddress" "eInvalidDate" "eInvalidLocation" "eInvalidSKU" "eInvalidMethod" "eIncomplete" "eIncompleteAddress" "eDuplicate" "eDuplicateSKU" "eUnexpected" "eUnexpectedDate" "eUnexpectedRoutingDelay" "ePotentialShipByDateDelay" "eRestock" "eOutOfStock" "eFraudSuspected" "eApprovalRequired" "ePartiallyCanceled" "eRouteNotFound" "eRouteOutOfStock" "eShippingMethod" "ePaymentRequired" "eUnfulfillable" "eTransform" "eShipmentMismatch" "eUnexpectedSplitShipment" "ePotentialOverfulfill" "eStuckShippingRequest" "eCreditMemoInsufficient" "eOrderSyncFailure" "eOrderTaxMismatch" "eInventoryOutOfStock"

Exception type

aiTip
string
autoEngUpdateStatus
string (AutoEngUpdateStatus)
Enum: "pending" "updated" "none"

A status that indicates whether or not the automation engine may update the entity sometime in the future. Only set internally. Useful for services such as the order routing engine where the user intended order state is critical before action. Used for orders and shipments.

Status definitions:

  • pending: the automation engine will make an update to this entity in the future.
  • updated: the automation engine has successfully made an update to this entity.
  • none: No status to set because the org did not have an enabled automation at the time of create/update.
autoEngUpdateStatusUpdatedAt
string <date-time> (AutoEngUpdateStatusUpdatedAt)

When the autoEngUpdateStatus was last updated

categoryId
string

Exception category ID

createdAt
string <date-time>

When the object was created within Pipe17

exceptionDetails
string

Exception specific error message/details

exceptionId
string

Exception ID

exceptionPriority
string (ExceptionPriority)
Enum: "high" "medium" "low"

Exception priority

exceptionSeverity
string (ExceptionSeverity)
Enum: "high" "medium" "low"

Exception severity

extEntityId
string

External Entity ID

extRelatedEntityId
string

External ID of Related Entity

integration
string

Reference to integration that created an item

object (InternalInfo)

Internal info

orgKey
string

Organization this object belong to

recommendation
string
relatedEntityId
string

Related Entity ID (e.g. for shipping request related entity is sales order or transfer order)

relatedEntityType
string (ExceptionEntityName)
Enum: "accounts" "apikey" "arrivals" "automation_rules" "automation_runs" "automations" "changelog" "connectors" "customers" "contacts" "entity_filters" "entity_schemas" "events" "exception_categories" "exception_filters" "exceptions" "fulfillments" "functions" "integration_actions" "integration_state" "integrations" "inventory" "inventoryrules" "invoices" "jobs" "labels" "locations" "lookup_objects" "mappings" "notes" "order_routing_runs" "order_routings" "orders" "organizations" "catalogs" "catalog_products" "pricing" "products" "purchases" "receipts" "references" "refunds" "returns" "roles" "routings" "shipment_boxes" "shipments" "shipping_methods" "statement_transactions" "statements" "suppliers" "trackings" "transfers" "usagedata" "usageplans" "users" "vendor_schemas" "webhooks"

Exception Entity Name

status
string (ExceptionStatus)
Enum: "active" "dismissed" "resolved"

Exception status

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "autoEngUpdateStatus": "pending",
  • "autoEngUpdateStatusUpdatedAt": "2019-08-24T14:15:22Z",
  • "categoryId": "string",
  • "exceptionId": "string",
  • "integration": "string",
  • "status": "active",
  • "entityId": "string",
  • "entityType": "accounts",
  • "exceptionType": "eAutomation",
  • "aiTip": "string",
  • "exceptionDetails": "string",
  • "exceptionPriority": "high",
  • "exceptionSeverity": "high",
  • "extEntityId": "string",
  • "extRelatedEntityId": "string",
  • "internal": {
    },
  • "recommendation": "string",
  • "relatedEntityId": "string",
  • "relatedEntityType": "accounts",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Exception

Uniqueness constraints within organization:

  • exception.integration, exception.entityType, exception.exceptionType, exception.status, exception.entityId (when status==active)
Authorizations:
Pipe17KeyAuth
Request Body schema:
entityId
required
string

Entity ID

entityType
required
string (ExceptionEntityName)
Enum: "accounts" "apikey" "arrivals" "automation_rules" "automation_runs" "automations" "changelog" "connectors" "customers" "contacts" "entity_filters" "entity_schemas" "events" "exception_categories" "exception_filters" "exceptions" "fulfillments" "functions" "integration_actions" "integration_state" "integrations" "inventory" "inventoryrules" "invoices" "jobs" "labels" "locations" "lookup_objects" "mappings" "notes" "order_routing_runs" "order_routings" "orders" "organizations" "catalogs" "catalog_products" "pricing" "products" "purchases" "receipts" "references" "refunds" "returns" "roles" "routings" "shipment_boxes" "shipments" "shipping_methods" "statement_transactions" "statements" "suppliers" "trackings" "transfers" "usagedata" "usageplans" "users" "vendor_schemas" "webhooks"

Exception Entity Name

exceptionType
required
string (ExceptionType)
Enum: "eAutomation" "eAutomationCodeFilterError" "eAutomationCodeActionError" "eGeneric" "eSyncFailure" "eUnacknowledged" "eDelayed" "eLate" "eLateCancel" "eEarly" "eLost" "eToday" "eSplit" "eStuck" "eLarge" "eLow" "eMissing" "eMissingSKU" "eMissingLocation" "eMismatch" "eMismatchTax" "eInvalid" "eInvalidAddress" "eInvalidDate" "eInvalidLocation" "eInvalidSKU" "eInvalidMethod" "eIncomplete" "eIncompleteAddress" "eDuplicate" "eDuplicateSKU" "eUnexpected" "eUnexpectedDate" "eUnexpectedRoutingDelay" "ePotentialShipByDateDelay" "eRestock" "eOutOfStock" "eFraudSuspected" "eApprovalRequired" "ePartiallyCanceled" "eRouteNotFound" "eRouteOutOfStock" "eShippingMethod" "ePaymentRequired" "eUnfulfillable" "eTransform" "eShipmentMismatch" "eUnexpectedSplitShipment" "ePotentialOverfulfill" "eStuckShippingRequest" "eCreditMemoInsufficient" "eOrderSyncFailure" "eOrderTaxMismatch" "eInventoryOutOfStock"

Exception type

aiTip
string
exceptionDetails
string

Exception specific error message/details

exceptionPriority
string (ExceptionPriority)
Enum: "high" "medium" "low"

Exception priority

exceptionSeverity
string (ExceptionSeverity)
Enum: "high" "medium" "low"

Exception severity

extEntityId
string

External Entity ID

extRelatedEntityId
string

External ID of Related Entity

object (InternalInfo)

Internal info

recommendation
string
relatedEntityId
string

Related Entity ID (e.g. for shipping request related entity is sales order or transfer order)

relatedEntityType
string (ExceptionEntityName)
Enum: "accounts" "apikey" "arrivals" "automation_rules" "automation_runs" "automations" "changelog" "connectors" "customers" "contacts" "entity_filters" "entity_schemas" "events" "exception_categories" "exception_filters" "exceptions" "fulfillments" "functions" "integration_actions" "integration_state" "integrations" "inventory" "inventoryrules" "invoices" "jobs" "labels" "locations" "lookup_objects" "mappings" "notes" "order_routing_runs" "order_routings" "orders" "organizations" "catalogs" "catalog_products" "pricing" "products" "purchases" "receipts" "references" "refunds" "returns" "roles" "routings" "shipment_boxes" "shipments" "shipping_methods" "statement_transactions" "statements" "suppliers" "trackings" "transfers" "usagedata" "usageplans" "users" "vendor_schemas" "webhooks"

Exception Entity Name

Responses

Request samples

Content type
{
  • "entityId": "string",
  • "entityType": "accounts",
  • "exceptionType": "eAutomation",
  • "aiTip": "string",
  • "exceptionDetails": "string",
  • "exceptionPriority": "high",
  • "exceptionSeverity": "high",
  • "extEntityId": "string",
  • "extRelatedEntityId": "string",
  • "internal": {
    },
  • "recommendation": "string",
  • "relatedEntityId": "string",
  • "relatedEntityType": "accounts"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "exception": {
    }
}

Delete Exception

Authorizations:
Pipe17KeyAuth
path Parameters
ExceptionId
required
string

Exception ID to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Exception

Authorizations:
Pipe17KeyAuth
path Parameters
ExceptionId
required
string

Exception ID to fetch

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "exception": {
    }
}

List Exceptions

Authorizations:
Pipe17KeyAuth
query Parameters
autoEngUpdateStatus
Array of strings (AutoEngUpdateStatus)
Items Enum: "pending" "updated" "none"

Return exceptions with the specified autoEngUpdateStatus values

autoEngUpdateStatusUpdatedSince
string <date-time>

Fetch with autoEngUpdateStatus updated after this date-time

autoEngUpdateStatusUpdatedUntil
string <date-time>

Fetch with autoEngUpdateStatus updated before this date-time

categoryId
Array of strings

Exceptions by categoryId-list

count
integer <int32>
Default: 100

Max number of exceptions to return

entityId
Array of strings

Exceptions related to this list of entities

entityType
Array of strings (ExceptionEntityName)
Items Enum: "accounts" "apikey" "arrivals" "automation_rules" "automation_runs" "automations" "changelog" "connectors" "customers" "contacts" "entity_filters" "entity_schemas" "events" "exception_categories" "exception_filters" "exceptions" "fulfillments" "functions" "integration_actions" "integration_state" "integrations" "inventory" "inventoryrules" "invoices" "jobs" "labels" "locations" "lookup_objects" "mappings" "notes" "order_routing_runs" "order_routings" "orders" "organizations" "catalogs" "catalog_products" "pricing" "products" "purchases" "receipts" "references" "refunds" "returns" "roles" "routings" "shipment_boxes" "shipments" "shipping_methods" "statement_transactions" "statements" "suppliers" "trackings" "transfers" "usagedata" "usageplans" "users" "vendor_schemas" "webhooks"

Exceptions related to list of entity types

exceptionDetails
Array of strings

Exceptions with the status active, which contain specified terms in the exceptionDetails field (wildcards * and ? are supported in any term, but not as the first character)

exceptionId
Array of strings

Exceptions by exceptionId-list

exceptionPriority
Array of strings (ExceptionPriority)
Items Enum: "high" "medium" "low"

Exceptions by exceptionPriority-list

exceptionSeverity
Array of strings (ExceptionSeverity)
Items Enum: "high" "medium" "low"

Exceptions by exceptionSeverity-list

exceptionType
Array of strings (ExceptionType)
Items Enum: "eAutomation" "eAutomationCodeFilterError" "eAutomationCodeActionError" "eGeneric" "eSyncFailure" "eUnacknowledged" "eDelayed" "eLate" "eLateCancel" "eEarly" "eLost" "eToday" "eSplit" "eStuck" "eLarge" "eLow" "eMissing" "eMissingSKU" "eMissingLocation" "eMismatch" "eMismatchTax" "eInvalid" "eInvalidAddress" "eInvalidDate" "eInvalidLocation" "eInvalidSKU" "eInvalidMethod" "eIncomplete" "eIncompleteAddress" "eDuplicate" "eDuplicateSKU" "eUnexpected" "eUnexpectedDate" "eUnexpectedRoutingDelay" "ePotentialShipByDateDelay" "eRestock" "eOutOfStock" "eFraudSuspected" "eApprovalRequired" "ePartiallyCanceled" "eRouteNotFound" "eRouteOutOfStock" "eShippingMethod" "ePaymentRequired" "eUnfulfillable" "eTransform" "eShipmentMismatch" "eUnexpectedSplitShipment" "ePotentialOverfulfill" "eStuckShippingRequest" "eCreditMemoInsufficient" "eOrderSyncFailure" "eOrderTaxMismatch" "eInventoryOutOfStock"

Exceptions by exceptionType-list

extEntityId
Array of strings

Exceptions related to this list of entities

extRelatedEntityId
Array of strings

Exceptions related to this list of related entities

integrationOwned
boolean

Exceptions created by current integration only

keys
string
Default: "exceptionId,categoryId,exceptionType,exceptionDetails,entityId,entityType,relatedEntityId,relatedEntityType,extEntityId,extRelatedEntityId,status,createdAt,updatedAt,orgKey"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

relatedEntityId
Array of strings

Exceptions related to this list of related entities

relatedEntityType
Array of strings (ExceptionEntityName)
Items Enum: "accounts" "apikey" "arrivals" "automation_rules" "automation_runs" "automations" "changelog" "connectors" "customers" "contacts" "entity_filters" "entity_schemas" "events" "exception_categories" "exception_filters" "exceptions" "fulfillments" "functions" "integration_actions" "integration_state" "integrations" "inventory" "inventoryrules" "invoices" "jobs" "labels" "locations" "lookup_objects" "mappings" "notes" "order_routing_runs" "order_routings" "orders" "organizations" "catalogs" "catalog_products" "pricing" "products" "purchases" "receipts" "references" "refunds" "returns" "roles" "routings" "shipment_boxes" "shipments" "shipping_methods" "statement_transactions" "statements" "suppliers" "trackings" "transfers" "usagedata" "usageplans" "users" "vendor_schemas" "webhooks"

Exceptions related to list of related entity types

since
string <date-time>

Exceptions created after this date-time

skip
integer <int32>
Default: 0

Number of exceptions to skip

status
Array of strings (ExceptionStatus)
Items Enum: "active" "dismissed" "resolved"

Exceptions by status-list

until
string <date-time>

Exceptions created before this date-time

updatedSince
string <date-time>

Exceptions updated after this date-time

updatedUntil
string <date-time>

Exceptions updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "exceptions": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Update Exception

Uniqueness constraints within organization:

  • exception.integration, exception.entityType, exception.exceptionType, exception.status, exception.entityId (when status==active)
Authorizations:
Pipe17KeyAuth
path Parameters
ExceptionId
required
string

Exception ID to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
aiTip
string or null
autoEngUpdateStatus
string (AutoEngUpdateStatus)
Enum: "pending" "updated" "none"

A status that indicates whether or not the automation engine may update the entity sometime in the future. Only set internally. Useful for services such as the order routing engine where the user intended order state is critical before action. Used for orders and shipments.

Status definitions:

  • pending: the automation engine will make an update to this entity in the future.
  • updated: the automation engine has successfully made an update to this entity.
  • none: No status to set because the org did not have an enabled automation at the time of create/update.
object (InternalInfo)

Internal info

recommendation
string or null
status
string (ExceptionStatus)
Enum: "active" "dismissed" "resolved"

Exception status

Responses

Request samples

Content type
{
  • "aiTip": "string",
  • "autoEngUpdateStatus": "pending",
  • "internal": {
    },
  • "recommendation": "string",
  • "status": "active"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "exception": {
    }
}

Integration Actions

Operations with Integration Actions

Integration Action Model

actionType
required
string

Action Type (matches to what is included in connector manifest)

integrationId
required
string

Integration ID

actionId
string

Integration action ID

actionName
string

Action Name - label for this action invocation

Array of objects (IntegrationActionParam)

Action parameters (array of parameters, collected for this action from user)

createdAt
string <date-time>

When the object was created within Pipe17

object (InternalInfo)

Internal info

orgKey
string

Organization this object belong to

progress
number

Percent action complete

status
string (IntegrationActionStatus)
Enum: "submitted" "processing" "completed" "canceled" "failed"

Integration action status

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "actionId": "string",
  • "progress": 0,
  • "status": "submitted",
  • "actionType": "string",
  • "integrationId": "string",
  • "actionName": "string",
  • "actionParams": [
    ],
  • "internal": {
    },
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Integration Action

Authorizations:
Pipe17KeyAuth
Request Body schema:
actionType
required
string

Action Type (matches to what is included in connector manifest)

integrationId
required
string

Integration ID

actionName
string

Action Name - label for this action invocation

Array of objects (IntegrationActionParam)

Action parameters (array of parameters, collected for this action from user)

object (InternalInfo)

Internal info

Responses

Request samples

Content type
{
  • "actionType": "string",
  • "integrationId": "string",
  • "actionName": "string",
  • "actionParams": [
    ],
  • "internal": {
    }
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "action": {
    }
}

Delete Integration Action

Authorizations:
Pipe17KeyAuth
path Parameters
IntegrationActionId
required
string

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Delete Integration Actions

Authorizations:
Pipe17KeyAuth
query Parameters
action
string (ListDeleteAction)
Default: "list"
Enum: "list" "soft"

Return the list of what to delete, or delete softly

actionId
Array of strings

Delete actions by list of actionId

actionType
Array of strings

Delete actions by list of actionType

count
integer <int32>
Default: 100

Max number of actions to delete

deleted
boolean

Delete soft deleted actions

integrationId
Array of strings

Delete actions by list of integrationId

since
string <date-time>

Delete actions created after this date-time

skip
integer <int32>
Default: 0

Number of actions to skip

status
Array of strings

Delete actions by list of statuses

until
string <date-time>

Delete actions created before this date-time

updatedSince
string <date-time>

Delete actions updated after this date-time

updatedUntil
string <date-time>

Delete actions updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "actions": [
    ],
  • "deleted": 0,
  • "filters": {
    },
  • "pagination": {
    }
}

Fetch Integration Action

Authorizations:
Pipe17KeyAuth
path Parameters
IntegrationActionId
required
string

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "action": {
    }
}

List Integration Actions

Authorizations:
Pipe17KeyAuth
query Parameters
actionId
Array of strings

Fetch actions by list of actionId

actionType
Array of strings

Fetch actions by list of actionType

count
integer <int32>
Default: 100

Max number of actions to return

deleted
boolean

Fetch soft deleted actions

integrationId
Array of strings

Fetch actions by list of integrationId

keys
string
Default: "actionId,actionType,actionName,actionParams,integrationId,createdAt,updatedAt,orgKey,status,progress"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Fetch actions created after this date-time

skip
integer <int32>
Default: 0

Number of actions to skip

status
Array of strings

Fetch actions by list of action statuses

until
string <date-time>

Fetch actions created before this date-time

updatedSince
string <date-time>

Fetch actions updated after this date-time

updatedUntil
string <date-time>

Fetch actions updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "actions": [
    ],
  • "filters": {
    }
}

Update Integration Action

Authorizations:
Pipe17KeyAuth
path Parameters
IntegrationActionId
required
string
query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
object (InternalInfo)

Internal info

progress
number

Action progress (0-100)

status
string (IntegrationActionStatus)
Enum: "submitted" "processing" "completed" "canceled" "failed"

Integration action status

Responses

Request samples

Content type
{
  • "internal": {
    },
  • "progress": 0,
  • "status": "submitted"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "action": {
    }
}

Integrations

Operations about Integrations

Integration Model

integrationName
required
string

Integration Name

Array of objects (IntegrationActionSimple)

List of integration actions

apikey
string

Integration api Key

capability
Array of strings
Items Enum: "arrivals:in" "arrivals:out" "customers:in" "customers:out" "contacts:in" "contacts:out" "fulfillments:in" "fulfillments:out" "inventory:in" "inventory:out" "labels:in" "labels:out" "locations:in" "locations:out" "orders:in" "orders:out" "products:in" "products:out" "purchases:in" "purchases:out" "receipts:in" "receipts:out" "refunds:in" "refunds:out" "returns:in" "returns:out" "shipments:in" "shipments:out" "suppliers:in" "suppliers:out" "transfers:in" "transfers:out" "shipping_methods" "sku_mapping" "shipments_cancel_in" "shipments_cancel_out" "events_outbound_replay" "events_outbound_batch" "inventory_requires_products" "orders_cancel_in" "orders_cancel_out" "inventory_incremental" "locations_multiple" "orders_multiple_destinations"
object (IntegrationConnection)

3rd party's credentials

connectorId
string

Connector ID (either Name or ID required)

connectorName
string

Connector Name (either Name or ID required)

createdAt
string <date-time>

When the object was created within Pipe17

Array of objects (IntegrationEntity)
environment
string (Env)
Enum: "test" "prod"

Environment ID

errorText
string

Error message

extIntegrationId
string

Unique integration identifier as defined by Connector logic

integrationId
string

Integration Id

object (InternalInfo)

Internal info

linkedConnectorId
string
linkedConnectorName
string
orgKey
string

Organization this object belong to

object (IntegrationSettings)

Connector specific

status
string (IntegrationStatus)
Enum: "created" "configured" "initializing" "connected" "error" "disabled" "future"

Integration Status

updatedAt
string <date-time>

When the object was updated within Pipe17

object
version
string

Integration version

{
  • "actions": [
    ],
  • "apikey": "string",
  • "capability": [
    ],
  • "linkedConnectorId": "string",
  • "linkedConnectorName": "string",
  • "errorText": "string",
  • "extIntegrationId": "string",
  • "integrationId": "string",
  • "status": "created",
  • "variables": {
    },
  • "version": "string",
  • "integrationName": "string",
  • "connection": {
    },
  • "connectorId": "string",
  • "connectorName": "string",
  • "entities": [
    ],
  • "environment": "test",
  • "internal": {
    },
  • "settings": {
    },
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Integration

Uniqueness constraints within organization:

  • integration.integrationName
Authorizations:
Pipe17KeyAuth
Request Body schema:
integrationName
required
string

Integration Name

object (IntegrationConnection)

3rd party's credentials

connectorId
string

Connector ID (either Name or ID required)

connectorName
string

Connector Name (either Name or ID required)

Array of objects (IntegrationEntity)
environment
string (Env)
Enum: "test" "prod"

Environment ID

object (InternalInfo)

Internal info

object (IntegrationSettings)

Connector specific

Responses

Request samples

Content type
{
  • "integrationName": "string",
  • "connection": {
    },
  • "connectorId": "string",
  • "connectorName": "string",
  • "entities": [
    ],
  • "environment": "test",
  • "internal": {
    },
  • "settings": {
    }
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "integration": {
    }
}

Delete Integration

Authorizations:
Pipe17KeyAuth
path Parameters
IntegrationId
required
string

Integration Id to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Integration

Authorizations:
Pipe17KeyAuth
path Parameters
IntegrationId
required
string

Integration Id to fetch

query Parameters
keys
string
Default: "*"

Return these top-level fields

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "integration": {
    }
}

Fetch Integration Variable(s)

Authorizations:
Pipe17KeyAuth
path Parameters
IntegrationId
required
string

Integration Id to update

query Parameters
name
Array of strings

Retrieve variables by list of their names

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "variables": {
    }
}

List Integrations

Authorizations:
Pipe17KeyAuth
query Parameters
capability
Array of strings (IntegrationCapability)
Items Enum: "arrivals:in" "arrivals:out" "customers:in" "customers:out" "contacts:in" "contacts:out" "fulfillments:in" "fulfillments:out" "inventory:in" "inventory:out" "labels:in" "labels:out" "locations:in" "locations:out" "orders:in" "orders:out" "products:in" "products:out" "purchases:in" "purchases:out" "receipts:in" "receipts:out" "refunds:in" "refunds:out" "returns:in" "returns:out" "shipments:in" "shipments:out" "suppliers:in" "suppliers:out" "transfers:in" "transfers:out" "shipping_methods" "sku_mapping" "shipments_cancel_in" "shipments_cancel_out" "events_outbound_replay" "events_outbound_batch" "inventory_requires_products" "orders_cancel_in" "orders_cancel_out" "inventory_incremental" "locations_multiple" "orders_multiple_destinations"

Retrieve connectors by list of capabilities

connectorId
Array of strings

Retrieve integrations by connector Id(s)

connectorName
Array of strings

Retrieve integrations by list of connector names

count
integer <int32>
Default: 100

Return at most this many integrations

extIntegrationId
Array of strings

Retrieve by list of extIntegrationId

integrationId
Array of strings

Retrieve by list of integrationId

keys
string
Default: "version,integrationId,integrationName,status,connectorName,connectorId,entities,settings,connection,createdAt,updatedAt,orgKey"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Integrations created after this date-time

skip
integer <int32>
Default: 0

Skip this many integrations

status
Array of strings (IntegrationStatus)
Items Enum: "created" "configured" "initializing" "connected" "error" "disabled" "future"

Retrieve integrations by status

until
string <date-time>

Integrations created before this date-time

updatedSince
string <date-time>

Integrations updated after this date-time

updatedUntil
string <date-time>

Integrations updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "integrations": [
    ],
  • "pagination": {
    }
}

Update Integration

Uniqueness constraints within organization:

  • integration.integrationName
Authorizations:
Pipe17KeyAuth
path Parameters
IntegrationId
required
string

Integration Id to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
apikey
boolean

Update integration api key

object (IntegrationConnection)

3rd party's credentials

Array of objects (IntegrationEntity)
errorText
string or null

Error message

extIntegrationId
string

Unique integration identifier as defined by Connector logic

integrationName
string

Integration Name

object (InternalInfo)

Internal info

object (IntegrationSettings)

Connector specific

status
string (IntegrationStatus)
Enum: "created" "configured" "initializing" "connected" "error" "disabled" "future"

Integration Status

object or null

Responses

Request samples

Content type
{
  • "apikey": true,
  • "connection": {
    },
  • "entities": [
    ],
  • "errorText": "string",
  • "extIntegrationId": "string",
  • "integrationName": "string",
  • "internal": {
    },
  • "settings": {
    },
  • "status": "created",
  • "variables": {
    }
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "integration": {
    }
}

Update Integration Variable(s)

Authorizations:
Pipe17KeyAuth
path Parameters
IntegrationId
required
string

Integration Id to update

Request Body schema:
object or null

Responses

Request samples

Content type
{
  • "variables": {
    }
}

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Upgrade Integration

Authorizations:
Pipe17KeyAuth
path Parameters
IntegrationId
required
string

Integration Id to upgrade

Request Body schema:
version
string

Connector version

Responses

Request samples

Content type
{
  • "version": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Mappings

Operations about Mappings

Mapping Model

description
required
string

Description

isPublic
required
boolean

Public mapping indicator

apikeyId
string

Id of apikey modified mapping

connectorId
string

Connector that uses this mapping

createdAt
string <date-time>

When the object was created within Pipe17

documentationURLs
Array of strings
object (InternalInfo)

Internal info

mappingId
string

Mapping ID

Array of objects (MappingRule)
orgKey
string

Organization this object belong to

originId
string
readme
string
updatedAt
string <date-time>

When the object was updated within Pipe17

userId
string

Id of user modified mapping

uuid
string

UUID (generated if not provided)

version
number

Mapping version

{
  • "apikeyId": "string",
  • "connectorId": "string",
  • "mappingId": "string",
  • "userId": "string",
  • "version": 0,
  • "description": "string",
  • "isPublic": true,
  • "documentationURLs": [
    ],
  • "internal": {
    },
  • "mappings": [
    ],
  • "originId": "string",
  • "readme": "string",
  • "uuid": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Mapping

Uniqueness constraints:

  • maping.uuid
Authorizations:
Pipe17KeyAuth
Request Body schema:
description
required
string

Description

isPublic
required
boolean

Public mapping indicator

documentationURLs
Array of strings
object (InternalInfo)

Internal info

Array of objects (MappingRule)
originId
string
readme
string
uuid
string

UUID (generated if not provided)

Responses

Request samples

Content type
{
  • "description": "string",
  • "isPublic": true,
  • "documentationURLs": [
    ],
  • "internal": {
    },
  • "mappings": [
    ],
  • "originId": "string",
  • "readme": "string",
  • "uuid": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "mapping": {
    }
}

Fetch Mapping

Authorizations:
Pipe17KeyAuth
path Parameters
MappingId
required
string

ID or uuid:{uuid} of mapping to fetch

query Parameters
merge
string (MappingsMergeMode)
Enum: "origin" "none"

Mapping merge mode

version
string

ID of mapping rules version to retrieve

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "mapping": {
    }
}

List Mappings

Authorizations:
Pipe17KeyAuth
query Parameters
connectorId
Array of strings

Mappings by list of connectorId

count
integer <int32>
Default: 100

Return at most this many mappings

desc
string

Fetch mappings by description (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

keys
string
Default: "mappingId,connectorId,uuid,description,createdAt,updatedAt,orgKey,isPublic,originId,documentationURLs,readme"

Return these top-level fields

mappingId
Array of strings

Mappings by list of mappingId

order
string
Default: "createdAt"

Sort by these top-level fields

originId
Array of strings

Mappings by list of originId

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Mappings created after this date-time

skip
integer <int32>
Default: 0

Skip this many mappings

until
string <date-time>

Mappings created before this date-time

updatedSince
string <date-time>

Mappings updated after this date-time

updatedUntil
string <date-time>

Mappings updated before this date-time

uuid
Array of strings

Mappings by list of UUIDs

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "mappings": [
    ],
  • "pagination": {
    }
}

Update Mapping

Uniqueness constraints:

  • mapping.uuid
Authorizations:
Pipe17KeyAuth
path Parameters
MappingId
required
string

ID or uuid:{uuid} of mapping to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
description
string

Description

documentationURLs
Array of strings or null
object (InternalInfo)

Internal info

isPublic
boolean

Public mapping indicator

Array of objects (MappingUpdateRule)
originId
string
readme
string or null

Responses

Request samples

Content type
{
  • "description": "string",
  • "documentationURLs": [
    ],
  • "internal": {
    },
  • "isPublic": true,
  • "mappings": [
    ],
  • "originId": "string",
  • "readme": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "mapping": {
    }
}

Notes

Operations about Notes

Note Model

changeSource
required
string (NoteChangeSource)
Enum: "ui" "api" "other"

Change source

changeType
required
string (NoteChangeType)
Enum: "config" "comment" "other"

Change type

entityId
required
string

Target entity ID

entityType
required
string

Target entity type

action
string (NoteAction)
Enum: "create" "update" "delete"

Action enum

createdAt
string <date-time>

When the object was created within Pipe17

eventId
string

Event ID associated with note

extEntityId
string

Target entity external ID

generatedText
string

Generated summary of changes

hasPostValue
boolean

Indicates the postValue is defined

hasPreValue
boolean

Indicates the preValue is defined

object (InternalInfo)

Internal info

isPublic
boolean

Public note indicator (default - true)

noteId
string

Note Id

orgKey
string

Organization this object belong to

postValue
object

Value of target entity after change

preValue
object

Value of target entity before change

reference
string
relatedEntityId
string

Related entity ID

relatedEntityType
string

Related entity type

relatedReference
string
severity
string (NoteSeverity)
Enum: "normal" "low" "high"

Note severity

status
string (NoteStatus)
Value: "valid"

Note status

tags
Array of strings (EntityTags)

Tags assigned to entity

text
string

Note content

updatedAt
string <date-time>

When the object was updated within Pipe17

userId
string

Author

{
  • "hasPostValue": true,
  • "hasPreValue": true,
  • "noteId": "string",
  • "userId": "string",
  • "changeSource": "ui",
  • "changeType": "config",
  • "entityId": "string",
  • "entityType": "string",
  • "action": "create",
  • "eventId": "string",
  • "extEntityId": "string",
  • "generatedText": "string",
  • "internal": {
    },
  • "isPublic": true,
  • "postValue": { },
  • "preValue": { },
  • "reference": "string",
  • "relatedEntityId": "string",
  • "relatedEntityType": "string",
  • "relatedReference": "string",
  • "severity": "normal",
  • "status": "valid",
  • "tags": [
    ],
  • "text": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Note

Authorizations:
Pipe17KeyAuth
Request Body schema:
changeSource
required
string (NoteChangeSource)
Enum: "ui" "api" "other"

Change source

changeType
required
string (NoteChangeType)
Enum: "config" "comment" "other"

Change type

entityId
required
string

Target entity ID

entityType
required
string

Target entity type

action
string (NoteAction)
Enum: "create" "update" "delete"

Action enum

eventId
string

Event ID associated with note

extEntityId
string

Target entity external ID

generatedText
string

Generated summary of changes

object (InternalInfo)

Internal info

isPublic
boolean

Public note indicator (default - true)

postValue
object

Value of target entity after change

preValue
object

Value of target entity before change

reference
string
relatedEntityId
string

Related entity ID

relatedEntityType
string

Related entity type

relatedReference
string
severity
string (NoteSeverity)
Enum: "normal" "low" "high"

Note severity

status
string (NoteStatus)
Value: "valid"

Note status

tags
Array of strings (EntityTags)

Tags assigned to entity

text
string

Note content

Responses

Request samples

Content type
{
  • "changeSource": "ui",
  • "changeType": "config",
  • "entityId": "string",
  • "entityType": "string",
  • "action": "create",
  • "eventId": "string",
  • "extEntityId": "string",
  • "generatedText": "string",
  • "internal": {
    },
  • "isPublic": true,
  • "postValue": { },
  • "preValue": { },
  • "reference": "string",
  • "relatedEntityId": "string",
  • "relatedEntityType": "string",
  • "relatedReference": "string",
  • "severity": "normal",
  • "status": "valid",
  • "tags": [
    ],
  • "text": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "note": {
    }
}

Delete Note

Authorizations:
Pipe17KeyAuth
path Parameters
NoteId
required
string

Note Id to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Note

Authorizations:
Pipe17KeyAuth
path Parameters
NoteId
required
string

Note Id to fetch

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "note": {
    }
}

List Notes

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Return at most this many Notes

entityId
Array of strings

Retrieve notes by entityId list

entityType
Array of strings

Retrieve notes by entityType list

eventId
Array of strings

Retrieve notes by eventId list

keys
string
Default: "hasPreValue,hasPostValue,changeSource,changeType,text,generatedText,noteId,entityId,entityType,extEntityId,relatedEntityId,relatedEntityType,eventId,isPublic,severity,tags,userId,createdAt,updatedAt,orgKey,status"

Return these top-level fields

noteId
Array of strings

Retrieve notes by noteId list

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

severity
Array of strings (NoteSeverity)
Items Enum: "normal" "low" "high"

Retrieve notes by severity list

since
string <date-time>

Notes created after this date-time

skip
integer <int32>
Default: 0

Skip this many Notes

status
Array of strings (NoteStatus)
Items Value: "valid"

Retrieve notes by status list

tags
Array of strings (EntityTags)

Tags assigned to entity

until
string <date-time>

Notes created before this date-time

updatedSince
string <date-time>

Notes updated after this date-time

updatedUntil
string <date-time>

Notes updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "notes": [
    ],
  • "pagination": {
    }
}

Update Note

Authorizations:
Pipe17KeyAuth
path Parameters
NoteId
required
string

Note Id to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
action
string (NoteAction)
Enum: "create" "update" "delete"

Action enum

generatedText
string or null

Generated summary of changes

object (InternalInfo)

Internal info

isPublic
boolean

Public note indicator

postValue
object or null

Value of target entity after change

preValue
object or null

Value of target entity before change

reference
string
relatedEntityId
string

Related entity ID

relatedEntityType
string

Related entity type

relatedReference
string
severity
string (NoteSeverity)
Enum: "normal" "low" "high"

Note severity

status
string (NoteStatus)
Value: "valid"

Note status

tags
Array of strings (EntityTags)

Tags assigned to entity

text
string

Note content

Responses

Request samples

Content type
{
  • "action": "create",
  • "generatedText": "string",
  • "internal": {
    },
  • "isPublic": true,
  • "postValue": { },
  • "preValue": { },
  • "reference": "string",
  • "relatedEntityId": "string",
  • "relatedEntityType": "string",
  • "relatedReference": "string",
  • "severity": "normal",
  • "status": "valid",
  • "tags": [
    ],
  • "text": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "note": {
    }
}

Webhooks

Operations about Webhooks

Webhook Model

apikey
required
string

Webhook api key

topics
required
Array of strings (WebhookTopics)
Items Enum: "arrivals" "fulfillments" "integrations" "integration_actions" "inventory" "labels" "locations" "orders" "products" "purchases" "receipts" "refunds" "returns" "shipments" "suppliers" "transfers" "trackings" "exceptions"

Webhook topics

url
required
string

Webhook URL

connectorId
string

Connector ID

createdAt
string <date-time>

When the object was created within Pipe17

integration
string

Integration ID

object (InternalInfo)

Internal info

orgKey
string

Organization this object belong to

updatedAt
string <date-time>

When the object was updated within Pipe17

webhookId
string

Webhook ID

{
  • "connectorId": "string",
  • "integration": "string",
  • "webhookId": "string",
  • "apikey": "string",
  • "topics": [
    ],
  • "url": "string",
  • "internal": {
    },
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Webhook

Authorizations:
Pipe17KeyAuth
Request Body schema:
apikey
required
string

Webhook api key

topics
required
Array of strings (WebhookTopics)
Items Enum: "arrivals" "fulfillments" "integrations" "integration_actions" "inventory" "labels" "locations" "orders" "products" "purchases" "receipts" "refunds" "returns" "shipments" "suppliers" "transfers" "trackings" "exceptions"

Webhook topics

url
required
string

Webhook URL

object (InternalInfo)

Internal info

Responses

Request samples

Content type
{
  • "apikey": "string",
  • "topics": [
    ],
  • "url": "string",
  • "internal": {
    }
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "webhook": {
    }
}

Delete Webhook

Authorizations:
Pipe17KeyAuth
path Parameters
WebhookId
required
string

Webhook ID to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Webhook

Authorizations:
Pipe17KeyAuth
path Parameters
WebhookId
required
string

Webhook ID to fetch

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "webhook": {
    }
}

List Webhooks

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Return at most this many webhooks

keys
string
Default: "createdAt,orgKey,topics,updatedAt,webhookId"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

related
boolean

Include related webhooks

since
string <date-time>

Webhooks created after this date-time

skip
integer <int32>
Default: 0

Skip this many webhooks

topic
string (WebhookTopics)
Enum: "arrivals" "fulfillments" "integrations" "integration_actions" "inventory" "labels" "locations" "orders" "products" "purchases" "receipts" "refunds" "returns" "shipments" "suppliers" "transfers" "trackings" "exceptions"

Webhooks for this topic

until
string <date-time>

Webhooks created before this date-time

updatedSince
string <date-time>

Webhooks updated after this date-time

updatedUntil
string <date-time>

Webhooks updated before this date-time

webhookId
Array of strings

Webhooks by list of webhookId

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "pagination": {
    },
  • "webhooks": [
    ]
}

Update Webhook

Authorizations:
Pipe17KeyAuth
path Parameters
WebhookId
required
string

Webhook ID to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
apikey
string

Webhook api key

object (InternalInfo)

Internal info

topics
Array of strings (WebhookTopics)
Items Enum: "arrivals" "fulfillments" "integrations" "integration_actions" "inventory" "labels" "locations" "orders" "products" "purchases" "receipts" "refunds" "returns" "shipments" "suppliers" "transfers" "trackings" "exceptions"

Webhook Topics

url
string

Webhook URL

Responses

Request samples

Content type
{
  • "apikey": "string",
  • "internal": {
    },
  • "topics": [
    ],
  • "url": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "webhook": {
    }
}

Accounts

Operations about Accounts

Account Model

activationKey
string

Account Activation Key

object (Branding)

Branding information

Array of objects (AccountContact)
createdAt
string <date-time>

When the object was created within Pipe17

deletedAt
string <date-time>
enforceMFA
string (AccountEnforceMFA)
Enum: "all" "primary" "selected"
expirationDate
string <date>
integrations
Array of strings

Account Integrations

object (InternalInfo)

Internal info

isMultiOrgAllowed
boolean

Indicates whether customer allowed to create secondary orgs

isRebrandingAllowed
boolean

Indicates whether customer allowed to re-brand app dashboard

orgKey
string

Organization this object belong to

pausedAt
string <date-time>
object (AccountPayment)
prodOrgLimit
number

Defines maximum number of 'production' orgs allowed for account (default - 1)

roleIds
Array of strings

Account Role IDs

secondaryOrgLimit
number

Defines maximum number of secondary orgs allowed for account (default - 0)

status
string (AccountStatusWithDeleted)
Enum: "pending" "active" "disabled" "paused" "deleted" "retired"

Account's Status

updatedAt
string <date-time>

When the object was updated within Pipe17

userId
string

Account User ID

{
  • "activationKey": "string",
  • "branding": {
    },
  • "contacts": [
    ],
  • "deletedAt": "2019-08-24T14:15:22Z",
  • "enforceMFA": "all",
  • "expirationDate": "2019-08-24",
  • "integrations": [
    ],
  • "internal": {
    },
  • "isMultiOrgAllowed": true,
  • "isRebrandingAllowed": true,
  • "pausedAt": "2019-08-24T14:15:22Z",
  • "payment": {
    },
  • "prodOrgLimit": 0,
  • "roleIds": [
    ],
  • "secondaryOrgLimit": 0,
  • "status": "pending",
  • "userId": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Fetch Account

Authorizations:
Pipe17KeyAuth
path Parameters
OrgKeyOrActivationKey
required
string

Account OrgKey to fetch

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "account": {
    }
}

List Accounts

Authorizations:
Pipe17KeyAuth
query Parameters
billingStatus
Array of strings (AccountBillingStatus)
Items Enum: "trial" "paid" "paidCanceled" "unpaid" "pastDue" "discontinued" "unknown"

Accounts by list of billingStatus

count
integer <int32>
Default: 100

Return at most this many accounts

deletedSince
string <date-time>

Accounts with deletedAt after this date-time

deletedUntil
string <date-time>

Accounts with deletedAt before this date-time

expirationSince
string <date-time>

Accounts with expiration after this date-time

expirationUntil
string <date-time>

Accounts with expiration before this date-time

isMultiOrgAllowed
boolean

Accounts by isMultiOrgAllowed

keys
string
Default: "activationKey,expirationDate,integrations,payment,roleIds,userId,orgKey,status,isMultiOrgAllowed,secondaryOrgLimit,prodOrgLimit,isRebrandingAllowed,createdAt,updatedAt"

Return these top-level fields

order
string
Default: "createdAt"

Sort by these top-level fields

orgKey
Array of strings

Accounts by list of orgKey

pagination
string
Value: "disabled"

Exclude pagination info from the response

pausedSince
string <date-time>

Accounts with pausedAt after this date-time

pausedUntil
string <date-time>

Accounts with pausedAt before this date-time

renewalSince
string <date-time>

Accounts with renewalDate after this date-time

renewalUntil
string <date-time>

Accounts with renewalDate before this date-time

since
string <date-time>

Accounts created after this date-time

skip
integer <int32>
Default: 0

Skip this many accounts

status
Array of strings (AccountStatusWithDeleted)
Items Enum: "pending" "active" "disabled" "paused" "deleted" "retired"

Accounts by list of status

until
string <date-time>

Accounts created before this date-time

updatedSince
string <date-time>

Accounts updated after this date-time

updatedUntil
string <date-time>

Accounts updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "accounts": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Update Account

Authorizations:
Pipe17KeyAuth
path Parameters
OrgKeyOrActivationKey
required
string

Account Activation key

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
Array of objects or null (AccountContact)
enforceMFA
string (AccountEnforceMFA)
Enum: "all" "primary" "selected"
expirationDate
string <date>
object (InternalInfo)

Internal info

isMultiOrgAllowed
boolean

Indicates whether customer allowed to create secondary orgs

isRebrandingAllowed
boolean

Indicates whether customer allowed to re-brand app dashboard

object or null (AccountPaymentUpdate)
prodOrgLimit
number

Defines maximum number of 'production' orgs allowed for account (default - 1)

secondaryOrgLimit
number

Defines maximum number of secondary orgs allowed for account (default - 0)

status
string (AccountStatus)
Enum: "pending" "active" "disabled" "paused" "retired"

Account's Status

Responses

Request samples

Content type
{
  • "contacts": [
    ],
  • "enforceMFA": "all",
  • "expirationDate": "2019-08-24",
  • "internal": {
    },
  • "isMultiOrgAllowed": true,
  • "isRebrandingAllowed": true,
  • "payment": {
    },
  • "prodOrgLimit": 0,
  • "secondaryOrgLimit": 0,
  • "status": "pending"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "account": {
    }
}

Organizations

Operations about Organizations

Organization Model

required
object (OrganizationAddress)
email
required
string

Organization Contact email

name
required
string

Organization Name

phone
required
string

Organization Contact Phone

tier
required
string (OrganizationServiceTier)
Enum: "free" "basic" "enterprise"

Organization Service Tier

timeZone
required
string (Timezone)
Enum: "Africa/Algiers" "Africa/Cairo" "Africa/Casablanca" "Africa/Harare" "Africa/Johannesburg" "Africa/Monrovia" "Africa/Nairobi" "America/Argentina/Buenos_Aires" "America/Bogota" "America/Caracas" "America/Chicago" "America/Chihuahua" "America/Denver" "America/Godthab" "America/Guatemala" "America/Guyana" "America/Halifax" "America/Indiana/Indianapolis" "America/Juneau" "America/La_Paz" "America/Lima" "America/Los_Angeles" "America/Mazatlan" "America/Mexico_City" "America/Monterrey" "America/Montevideo" "America/New_York" "America/Phoenix" "America/Puerto_Rico" "America/Regina" "America/Santiago" "America/Sao_Paulo" "America/St_Johns" "America/Tijuana" "Asia/Almaty" "Asia/Baghdad" "Asia/Baku" "Asia/Bangkok" "Asia/Chongqing" "Asia/Colombo" "Asia/Dhaka" "Asia/Hong_Kong" "Asia/Irkutsk" "Asia/Jakarta" "Asia/Jerusalem" "Asia/Kabul" "Asia/Kamchatka" "Asia/Karachi" "Asia/Kathmandu" "Asia/Kolkata" "Asia/Krasnoyarsk" "Asia/Kuala_Lumpur" "Asia/Kuwait" "Asia/Magadan" "Asia/Muscat" "Asia/Novosibirsk" "Asia/Rangoon" "Asia/Riyadh" "Asia/Seoul" "Asia/Shanghai" "Asia/Singapore" "Asia/Srednekolymsk" "Asia/Taipei" "Asia/Tashkent" "Asia/Tbilisi" "Asia/Tehran" "Asia/Tokyo" "Asia/Ulaanbaatar" "Asia/Urumqi" "Asia/Vladivostok" "Asia/Yakutsk" "Asia/Yekaterinburg" "Asia/Yerevan" "Atlantic/Azores" "Atlantic/Cape_Verde" "Atlantic/South_Georgia" "Australia/Adelaide" "Australia/Brisbane" "Australia/Darwin" "Australia/Hobart" "Australia/Melbourne" "Australia/Perth" "Australia/Sydney" "Etc/UTC" "Europe/Amsterdam" "Europe/Athens" "Europe/Belgrade" "Europe/Berlin" "Europe/Bratislava" "Europe/Brussels" "Europe/Bucharest" "Europe/Budapest" "Europe/Copenhagen" "Europe/Dublin" "Europe/Helsinki" "Europe/Istanbul" "Europe/Kaliningrad" "Europe/Kiev" "Europe/Lisbon" "Europe/Ljubljana" "Europe/London" "Europe/Madrid" "Europe/Minsk" "Europe/Moscow" "Europe/Paris" "Europe/Prague" "Europe/Riga" "Europe/Rome" "Europe/Samara" "Europe/Sarajevo" "Europe/Skopje" "Europe/Sofia" "Europe/Stockholm" "Europe/Tallinn" "Europe/Vienna" "Europe/Vilnius" "Europe/Volgograd" "Europe/Warsaw" "Europe/Zagreb" "Europe/Zurich" "Pacific/Apia" "Pacific/Auckland" "Pacific/Chatham" "Pacific/Fakaofo" "Pacific/Fiji" "Pacific/Guadalcanal" "Pacific/Guam" "Pacific/Honolulu" "Pacific/Majuro" "Pacific/Midway" "Pacific/Noumea" "Pacific/Pago_Pago" "Pacific/Port_Moresby" "Pacific/Tongatapu"

Timezone

accountId
string

Parent account Id

object (Branding)

Branding information

Array of objects (OrganizationContact)
createdAt
string <date-time>

When the object was created within Pipe17

object (InternalInfo)

Internal info

isHoldingOrg
boolean

Marks organization as holding, i.e. parent org with no access to business objects.

logoUrl
string

Logo URL

monitoringEnabled
boolean

Allows the internal pipe 17 folks to enable/disable monitoring on the internal app (default - false)

orgKey
string

Organization this object belong to

orgMode
string (OrganizationMode)
Enum: "sandbox" "production" "internal" "demo"

Organization Mode

Array of objects (OrganizationSetting)

Organization level settings

status
string (OrganizationStatus)
Enum: "pending" "active" "disabled"

Organization Account Status

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "accountId": "string",
  • "branding": {
    },
  • "isHoldingOrg": true,
  • "status": "pending",
  • "address": {
    },
  • "email": "string",
  • "name": "string",
  • "phone": "string",
  • "tier": "free",
  • "timeZone": "Africa/Algiers",
  • "contacts": [
    ],
  • "internal": {
    },
  • "logoUrl": "string",
  • "monitoringEnabled": true,
  • "orgMode": "sandbox",
  • "settings": [
    ],
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Cleanup organization

Authorizations:
Pipe17KeyAuth
path Parameters
OrgKey
required
string

orgKey to cleanup

Request Body schema:
orgModes
required
Array of strings (OrganizationMode)
Items Enum: "sandbox" "production" "internal" "demo"

Only cleanup entities assigned this orgModes

entityTypes
Array of strings (EntityName)
Items Enum: "accounts" "arrivals" "automations" "automation_rules" "automation_runs" "changelog" "connectors" "customers" "contacts" "entity_filters" "exceptions" "fulfillments" "functions" "inventory" "inventoryrules" "invoices" "labels" "locations" "lookup_objects" "orders" "order_regions" "order_routings" "catalogs" "catalog_products" "products" "purchases" "receipts" "refunds" "returns" "shipments" "shipment_boxes" "shipping_methods" "statements" "statement_transactions" "suppliers" "transfers" "trackings" "usagedata" "usageplans" "vendor_schemas"

Only cleanup entities of these types

hardDelete
boolean

Use hard delete for data cleanup

Responses

Request samples

Content type
{
  • "orgModes": [
    ],
  • "entityTypes": [
    ],
  • "hardDelete": true
}

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Create Organization

Authorizations:
Pipe17KeyAuth
query Parameters
ownerMode
string
Enum: "primary" "owner" "both"
Request Body schema:
required
object (OrganizationAddress)
email
required
string

Organization Contact email

name
required
string

Organization Name

phone
required
string

Organization Contact Phone

tier
required
string (OrganizationServiceTier)
Enum: "free" "basic" "enterprise"

Organization Service Tier

timeZone
required
string (Timezone)
Enum: "Africa/Algiers" "Africa/Cairo" "Africa/Casablanca" "Africa/Harare" "Africa/Johannesburg" "Africa/Monrovia" "Africa/Nairobi" "America/Argentina/Buenos_Aires" "America/Bogota" "America/Caracas" "America/Chicago" "America/Chihuahua" "America/Denver" "America/Godthab" "America/Guatemala" "America/Guyana" "America/Halifax" "America/Indiana/Indianapolis" "America/Juneau" "America/La_Paz" "America/Lima" "America/Los_Angeles" "America/Mazatlan" "America/Mexico_City" "America/Monterrey" "America/Montevideo" "America/New_York" "America/Phoenix" "America/Puerto_Rico" "America/Regina" "America/Santiago" "America/Sao_Paulo" "America/St_Johns" "America/Tijuana" "Asia/Almaty" "Asia/Baghdad" "Asia/Baku" "Asia/Bangkok" "Asia/Chongqing" "Asia/Colombo" "Asia/Dhaka" "Asia/Hong_Kong" "Asia/Irkutsk" "Asia/Jakarta" "Asia/Jerusalem" "Asia/Kabul" "Asia/Kamchatka" "Asia/Karachi" "Asia/Kathmandu" "Asia/Kolkata" "Asia/Krasnoyarsk" "Asia/Kuala_Lumpur" "Asia/Kuwait" "Asia/Magadan" "Asia/Muscat" "Asia/Novosibirsk" "Asia/Rangoon" "Asia/Riyadh" "Asia/Seoul" "Asia/Shanghai" "Asia/Singapore" "Asia/Srednekolymsk" "Asia/Taipei" "Asia/Tashkent" "Asia/Tbilisi" "Asia/Tehran" "Asia/Tokyo" "Asia/Ulaanbaatar" "Asia/Urumqi" "Asia/Vladivostok" "Asia/Yakutsk" "Asia/Yekaterinburg" "Asia/Yerevan" "Atlantic/Azores" "Atlantic/Cape_Verde" "Atlantic/South_Georgia" "Australia/Adelaide" "Australia/Brisbane" "Australia/Darwin" "Australia/Hobart" "Australia/Melbourne" "Australia/Perth" "Australia/Sydney" "Etc/UTC" "Europe/Amsterdam" "Europe/Athens" "Europe/Belgrade" "Europe/Berlin" "Europe/Bratislava" "Europe/Brussels" "Europe/Bucharest" "Europe/Budapest" "Europe/Copenhagen" "Europe/Dublin" "Europe/Helsinki" "Europe/Istanbul" "Europe/Kaliningrad" "Europe/Kiev" "Europe/Lisbon" "Europe/Ljubljana" "Europe/London" "Europe/Madrid" "Europe/Minsk" "Europe/Moscow" "Europe/Paris" "Europe/Prague" "Europe/Riga" "Europe/Rome" "Europe/Samara" "Europe/Sarajevo" "Europe/Skopje" "Europe/Sofia" "Europe/Stockholm" "Europe/Tallinn" "Europe/Vienna" "Europe/Vilnius" "Europe/Volgograd" "Europe/Warsaw" "Europe/Zagreb" "Europe/Zurich" "Pacific/Apia" "Pacific/Auckland" "Pacific/Chatham" "Pacific/Fakaofo" "Pacific/Fiji" "Pacific/Guadalcanal" "Pacific/Guam" "Pacific/Honolulu" "Pacific/Majuro" "Pacific/Midway" "Pacific/Noumea" "Pacific/Pago_Pago" "Pacific/Port_Moresby" "Pacific/Tongatapu"

Timezone

Array of objects (OrganizationContact)
object (InternalInfo)

Internal info

logoUrl
string

Logo URL

monitoringEnabled
boolean

Allows the internal pipe 17 folks to enable/disable monitoring on the internal app (default - false)

orgMode
string (OrganizationMode)
Enum: "sandbox" "production" "internal" "demo"

Organization Mode

Array of objects (OrganizationSetting)

Organization level settings

Responses

Request samples

Content type
{
  • "address": {
    },
  • "email": "string",
  • "name": "string",
  • "phone": "string",
  • "tier": "free",
  • "timeZone": "Africa/Algiers",
  • "contacts": [
    ],
  • "internal": {
    },
  • "logoUrl": "string",
  • "monitoringEnabled": true,
  • "orgMode": "sandbox",
  • "settings": [
    ]
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "organization": {
    }
}

Delete Organization

Authorizations:
Pipe17KeyAuth
path Parameters
OrganizationId
required
string

Organization Id to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Detach secondary organization into separate account

Authorizations:
Pipe17KeyAuth
path Parameters
OrgKey
required
string

orgKey to detach

Request Body schema:
object (OrganizationDetachRequest)

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Organization

Authorizations:
Pipe17KeyAuth
path Parameters
OrganizationId
required
string

Organization Id to fetch

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "organization": {
    }
}

List Organizations

Authorizations:
Pipe17KeyAuth
query Parameters
accountId
Array of strings

Organizations by list of accountId

count
integer <int32>
Default: 100

Return at most this many organizations

deleted
boolean

Fetch only soft-deleted organizations (ignore status)

email
string

Organizations by email (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

keys
string
Default: "orgKey,accountId,name,tier,status,isHoldingOrg,createdAt,updatedAt"

Return these top-level fields

name
string

Organizations by name (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

order
string
Default: "createdAt"

Sort by these top-level fields

orgKey
Array of strings

Organizations by list of orgKey

orgMode
Array of strings (OrganizationMode)
Items Enum: "sandbox" "production" "internal" "demo"

Organizations by list of modes

pagination
string
Value: "disabled"

Exclude pagination info from the response

phone
string

Organizations by phone (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

since
string <date-time>

Organizations created after this date-time

skip
integer <int32>
Default: 0

Skip this many organizations

status
Array of strings (OrganizationStatus)
Items Enum: "pending" "active" "disabled"

Organizations by list of statuses

until
string <date-time>

Organizations created before this date-time

updatedSince
string <date-time>

Organizations updated after this date-time

updatedUntil
string <date-time>

Organizations updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "organizations": [
    ],
  • "pagination": {
    }
}

Move organization to another account

Authorizations:
Pipe17KeyAuth
path Parameters
OrgKey
required
string

orgKey to move

Request Body schema:
accountId
required
string

Target account ID

Responses

Request samples

Content type
{
  • "accountId": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Switch organization mode

Authorizations:
Pipe17KeyAuth
path Parameters
OrgKey
required
string

orgKey to switch

Request Body schema:
orgMode
required
string (OrganizationMode)
Enum: "sandbox" "production" "internal" "demo"

Organization Mode

Responses

Request samples

Content type
{
  • "orgMode": "sandbox"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update Organization

Authorizations:
Pipe17KeyAuth
path Parameters
OrganizationId
required
string

Organization Id to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
object (OrganizationUpdateAddress)
object (Branding)

Branding information

Array of objects or null (OrganizationContact)
email
string

Organization Contact email

object (InternalInfo)

Internal info

isHoldingOrg
boolean

Marks organization as holding, i.e. parent org with no access to business objects.

logoUrl
string

Logo URL

monitoringEnabled
boolean or null

Allows the internal pipe 17 folks to enable/disable monitoring on the internal app

name
string

Organization Name

phone
string

Organization Contact Phone

Array of objects (OrganizationSetting)

Organization level settings

status
string (OrganizationStatus)
Enum: "pending" "active" "disabled"

Organization Account Status

tier
string (OrganizationServiceTier)
Enum: "free" "basic" "enterprise"

Organization Service Tier

timeZone
string (Timezone)
Enum: "Africa/Algiers" "Africa/Cairo" "Africa/Casablanca" "Africa/Harare" "Africa/Johannesburg" "Africa/Monrovia" "Africa/Nairobi" "America/Argentina/Buenos_Aires" "America/Bogota" "America/Caracas" "America/Chicago" "America/Chihuahua" "America/Denver" "America/Godthab" "America/Guatemala" "America/Guyana" "America/Halifax" "America/Indiana/Indianapolis" "America/Juneau" "America/La_Paz" "America/Lima" "America/Los_Angeles" "America/Mazatlan" "America/Mexico_City" "America/Monterrey" "America/Montevideo" "America/New_York" "America/Phoenix" "America/Puerto_Rico" "America/Regina" "America/Santiago" "America/Sao_Paulo" "America/St_Johns" "America/Tijuana" "Asia/Almaty" "Asia/Baghdad" "Asia/Baku" "Asia/Bangkok" "Asia/Chongqing" "Asia/Colombo" "Asia/Dhaka" "Asia/Hong_Kong" "Asia/Irkutsk" "Asia/Jakarta" "Asia/Jerusalem" "Asia/Kabul" "Asia/Kamchatka" "Asia/Karachi" "Asia/Kathmandu" "Asia/Kolkata" "Asia/Krasnoyarsk" "Asia/Kuala_Lumpur" "Asia/Kuwait" "Asia/Magadan" "Asia/Muscat" "Asia/Novosibirsk" "Asia/Rangoon" "Asia/Riyadh" "Asia/Seoul" "Asia/Shanghai" "Asia/Singapore" "Asia/Srednekolymsk" "Asia/Taipei" "Asia/Tashkent" "Asia/Tbilisi" "Asia/Tehran" "Asia/Tokyo" "Asia/Ulaanbaatar" "Asia/Urumqi" "Asia/Vladivostok" "Asia/Yakutsk" "Asia/Yekaterinburg" "Asia/Yerevan" "Atlantic/Azores" "Atlantic/Cape_Verde" "Atlantic/South_Georgia" "Australia/Adelaide" "Australia/Brisbane" "Australia/Darwin" "Australia/Hobart" "Australia/Melbourne" "Australia/Perth" "Australia/Sydney" "Etc/UTC" "Europe/Amsterdam" "Europe/Athens" "Europe/Belgrade" "Europe/Berlin" "Europe/Bratislava" "Europe/Brussels" "Europe/Bucharest" "Europe/Budapest" "Europe/Copenhagen" "Europe/Dublin" "Europe/Helsinki" "Europe/Istanbul" "Europe/Kaliningrad" "Europe/Kiev" "Europe/Lisbon" "Europe/Ljubljana" "Europe/London" "Europe/Madrid" "Europe/Minsk" "Europe/Moscow" "Europe/Paris" "Europe/Prague" "Europe/Riga" "Europe/Rome" "Europe/Samara" "Europe/Sarajevo" "Europe/Skopje" "Europe/Sofia" "Europe/Stockholm" "Europe/Tallinn" "Europe/Vienna" "Europe/Vilnius" "Europe/Volgograd" "Europe/Warsaw" "Europe/Zagreb" "Europe/Zurich" "Pacific/Apia" "Pacific/Auckland" "Pacific/Chatham" "Pacific/Fakaofo" "Pacific/Fiji" "Pacific/Guadalcanal" "Pacific/Guam" "Pacific/Honolulu" "Pacific/Majuro" "Pacific/Midway" "Pacific/Noumea" "Pacific/Pago_Pago" "Pacific/Port_Moresby" "Pacific/Tongatapu"

Timezone

Responses

Request samples

Content type
{
  • "address": {
    },
  • "branding": {
    },
  • "contacts": [
    ],
  • "email": "string",
  • "internal": {
    },
  • "isHoldingOrg": true,
  • "logoUrl": "string",
  • "monitoringEnabled": true,
  • "name": "string",
  • "phone": "string",
  • "settings": [
    ],
  • "status": "pending",
  • "tier": "free",
  • "timeZone": "Africa/Algiers"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "organization": {
    }
}

Pricing

Operations about Pricing

Pricing Model

activeUntil
required
string <date-time> (PricingActiveUntil)

When the plan is active until in the pricing catalog, if date is in the past, the plan is a legacy plan

annualAmount
required
number <float>

Payment, USD, when paying annualy

excess
required
number <float>

USD, per order, for orders over included number

included
required
number <int32>

Number of orders included in plan per year

monthlyAmount
required
number <float>

Payment, USD, when paying monthly

name
required
string

Name of pricing Plan

rank
required
number <float>

Rank of pricing plan, higher has more features

sources
required
Array of strings (PricingSources)
Items Enum: "app" "shopify" "shopify-mcf"

Plan is available through these sources

api
boolean

If true, plan includes use of API

bundles
boolean

If true, plan includes use of bundles

categories
Array of strings
createdAt
string <date-time>

When the object was created within Pipe17

cutOver
number

when exceeding this number of orders in a year, recommend higher ranked plan

description
string

Pricing plan description

includedMonthly
number <int32>

Number of orders included in plan per month

object (InternalInfo)

Internal info

max3pl
number

Number of fulfillment integrations allowed in plan

maxERP
number

Number of ERP integrations allowed in plan

maxIntg
number

Number of integrations allowed in plan

maxSub
number

Number of secondary organizations allowed in plan

orgKey
string

Organization this object belong to

poto
boolean

If true, plan includes use Purchase / Transfer orders

pricingId
string

Pricing ID

routing
boolean

If true, plan includes order routing

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "pricingId": "string",
  • "activeUntil": "2019-08-24T14:15:22Z",
  • "annualAmount": 0,
  • "excess": 0,
  • "included": 0,
  • "monthlyAmount": 0,
  • "name": "string",
  • "rank": 0,
  • "sources": [
    ],
  • "api": true,
  • "bundles": true,
  • "categories": [
    ],
  • "cutOver": 0,
  • "description": "string",
  • "includedMonthly": 0,
  • "internal": {
    },
  • "max3pl": 0,
  • "maxERP": 0,
  • "maxIntg": 0,
  • "maxSub": 0,
  • "poto": true,
  • "routing": true,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Fetch a Pricing plan

Authorizations:
Pipe17KeyAuth
path Parameters
PricingId
required
string

Id or name:{name} of pricing plan to fetch

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "Pricing": {
    }
}

List Pricing plans

Authorizations:
Pipe17KeyAuth
query Parameters
active
boolean

Pricing plans that are active

api
boolean

Pricing plans allowing use of API

bundles
boolean

Pricing plans allowing use of bundles

categories
Array of strings

Pricing plans allowing use of all of these connector categories

count
integer <int32>
Default: 100

Return at most this many pricing plans

keys
string
Default: "pricingId,name,description,rank,monthlyAmount,annualAmount,included,includedMonthly,excess,cutOver,max3pl,maxERP,maxIntg,maxSub,routing,bundles,api,poto,categories,activeUntil,sources,createdAt,updatedAt"

Return these top-level fields

min3pl
integer <int32>
Default: 0

Pricing plans allowing at least this many 3pl integrations

minIncluded
integer <int32>
Default: 0

Pricing plans including at least this many orders a year

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

poto
boolean

Pricing plans allowing use of Purchase / Transfer orders

routing
boolean

Pricing plans allowing use of order routing

since
string <date-time>

Pricing plans created after this date-time

skip
integer <int32>
Default: 0

Skip this many pricing plans

sources
Array of strings (PricingSources)
Items Enum: "app" "shopify" "shopify-mcf"

Pricing plans available through these billing sources

until
string <date-time>

Pricing plans created before this date-time

updatedSince
string <date-time>

Pricing plans updated after this date-time

updatedUntil
string <date-time>

Pricing plans updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "Pricing": [
    ],
  • "filters": {
    },
  • "pagination": {
    }
}

Roles

Operations about User Roles

User Role Model

name
required
string

Role Name

createdAt
string <date-time>

When the object was created within Pipe17

description
string

Role's description

object (InternalInfo)

Internal info

isPublic
boolean

Global role indicator

object (Methods)

Access Methods Allowed

orgKey
string

Organization this object belong to

roleId
string

Role ID

status
string (RoleStatus)
Enum: "active" "disabled"

Role status

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "roleId": "string",
  • "status": "active",
  • "name": "string",
  • "description": "string",
  • "internal": {
    },
  • "isPublic": true,
  • "methods": {
    },
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Role

Uniqueness constraints within organization:

  • role.name
Authorizations:
Pipe17KeyAuth
Request Body schema:
name
required
string

Role Name

description
string

Role's description

object (InternalInfo)

Internal info

isPublic
boolean

Global role indicator

object (Methods)

Access Methods Allowed

Responses

Request samples

Content type
{
  • "name": "string",
  • "description": "string",
  • "internal": {
    },
  • "isPublic": true,
  • "methods": {
    }
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "role": {
    }
}

Delete Role

Authorizations:
Pipe17KeyAuth
path Parameters
RoleId
required
string

Role Id to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Role

Authorizations:
Pipe17KeyAuth
path Parameters
RoleId
required
string

Role Id to fetch

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "role": {
    }
}

List Roles

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Return at most this many roles

keys
string
Default: "isPublic,roleId,name,status,createdAt,updatedAt,orgKey"

Return these top-level fields

name
string

Roles by name (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

roleId
Array of strings

Roles by list of roleId

since
string <date-time>

Roles created after this date-time

skip
integer <int32>
Default: 0

Skip this many roles

status
Array of strings (RoleStatus)
Items Enum: "active" "disabled"

Roles by list of statuses

until
string <date-time>

Roles created before this date-time

updatedSince
string <date-time>

Roles updated after this date-time

updatedUntil
string <date-time>

Roles updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "pagination": {
    },
  • "roles": [
    ]
}

Update Role

Uniqueness constraints within organization:

  • role.name
Authorizations:
Pipe17KeyAuth
path Parameters
RoleId
required
string

Role Id to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
description
string

Role's description

object (InternalInfo)

Internal info

object (MethodsUpdateData)

Access Methods Allowed

name
string

Role Name

status
string (RoleStatus)
Enum: "active" "disabled"

Role status

Responses

Request samples

Content type
{
  • "description": "string",
  • "internal": {
    },
  • "methods": {
    },
  • "name": "string",
  • "status": "active"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "role": {
    }
}

Users

Operations about Users

User Model

email
required
string

User email

name
required
string

User Name

roles
required
Array of strings

User role names/ids

object (UserAddress)
blockedFeatures
Array of strings
createdAt
string <date-time>

When the object was created within Pipe17

description
string

User Description

object (InternalInfo)

Internal info

object (UserLoginInfo)
object (Methods)

Access Methods Allowed

orgKey
string

Organization this object belong to

phone
string

User Phone

status
string (UserStatus)
Enum: "pending" "active" "disabled"

User Status

timeZone
string

User Time Zone

updatedAt
string <date-time>

When the object was updated within Pipe17

userId
string

User ID

{
  • "loginInfo": {
    },
  • "methods": {
    },
  • "status": "pending",
  • "userId": "string",
  • "email": "string",
  • "name": "string",
  • "roles": [
    ],
  • "address": {
    },
  • "blockedFeatures": [
    ],
  • "description": "string",
  • "internal": {
    },
  • "phone": "string",
  • "timeZone": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create User

Uniqueness constraints within organization:

  • user.email
Authorizations:
Pipe17KeyAuth
Request Body schema:
email
required
string

User email

name
required
string

User Name

password
required
string

User password

roles
required
Array of strings

User role names/ids

object (UserAddress)
blockedFeatures
Array of strings
description
string

User Description

object (InternalInfo)

Internal info

phone
string

User Phone

timeZone
string

User Time Zone

Responses

Request samples

Content type
{
  • "email": "string",
  • "name": "string",
  • "roles": [
    ],
  • "address": {
    },
  • "blockedFeatures": [
    ],
  • "description": "string",
  • "internal": {
    },
  • "phone": "string",
  • "timeZone": "string",
  • "password": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "user": {
    }
}

Delete User

Authorizations:
Pipe17KeyAuth
path Parameters
UserId
required
string

User ID to delete

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch User

Authorizations:
Pipe17KeyAuth
path Parameters
UserId
required
string

User ID or me

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "user": {
    }
}

List Users

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Return at most this many users

email
string

Users by email (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

keys
string
Default: "userId,address,description,name,email,phone,roles,status,timeZone,createdAt,updatedAt,orgKey"

Return these top-level fields

name
string

Users by name (strings "/{pattern}/" and "/{pattern}/i" are interpreted as regexps)

order
string
Default: "createdAt"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

roles
Array of strings

Users by list of role names or/and role ids

since
string <date-time>

Users created after this date-time

skip
integer <int32>
Default: 0

Skip this many users

status
Array of strings (UserStatus)
Items Enum: "pending" "active" "disabled"

Users by list of statuses

until
string <date-time>

Users created before this date-time

updatedSince
string <date-time>

Users updated after this date-time

updatedUntil
string <date-time>

Users updated before this date-time

userId
Array of strings

Users by list of userId

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "pagination": {
    },
  • "users": [
    ]
}

Reset user's MFA

Authorizations:
Pipe17KeyAuth
path Parameters
UserId
required
string
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "user": {
    }
}

Reset user's password

Authorizations:
Pipe17KeyAuth
path Parameters
UserId
required
string
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "user": {
    }
}

Send verification email to user

Authorizations:
Pipe17KeyAuth
path Parameters
UserId
required
string
Request Body schema:
object

Responses

Request samples

Content type
{ }

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Update User

Uniqueness constraints within organization:

  • user.email
Authorizations:
Pipe17KeyAuth
path Parameters
UserId
required
string

User ID to update

query Parameters
keys
string
Default: ""

Comma-separated fields to be returned ("*" - all)

Request Body schema:
object (UserAddress)
blockedFeatures
Array of strings or null
description
string

User Description

object (InternalInfo)

Internal info

name
string

User Name

password
string

User password

phone
string

User Phone

roles
Array of strings

User role names/ids

status
string
Enum: "active" "disabled"
timeZone
string

User Time Zone

Responses

Request samples

Content type
{
  • "address": {
    },
  • "blockedFeatures": [
    ],
  • "description": "string",
  • "internal": {
    },
  • "name": "string",
  • "password": "string",
  • "phone": "string",
  • "roles": [
    ],
  • "status": "active",
  • "timeZone": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "user": {
    }
}

Conversion Functions

Function Object Model

body
required
string

Body of javascript function. The function signature - function(input):any. Body example - "return input.toUpperCase()".

name
required
string

Name of the function

createdAt
string <date-time>

When the object was created within Pipe17

functionId
string

Function ID

isPublic
boolean

Public access indicator (default - false)

orgKey
string

Organization this object belong to

updatedAt
string <date-time>

When the object was updated within Pipe17

{
  • "functionId": "string",
  • "body": "string",
  • "name": "string",
  • "isPublic": true,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Functions

  • Each public function has an unique name
  • Name of each non-public function is unique within organization
Authorizations:
Pipe17KeyAuth
Request Body schema:
Array (<= 100 items)
body
required
string

Body of javascript function. The function signature - function(input):any. Body example - "return input.toUpperCase()".

name
required
string

Name of the function

isPublic
boolean

Public access indicator (default - false)

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "functions": [
    ]
}

Delete Function

Authorizations:
Pipe17KeyAuth
path Parameters
FunctionId
required
string

The functionId or name:{name}. In the 2nd case, if the named non-public function does not exist, the target will be a public function with the same name.

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Function

Authorizations:
Pipe17KeyAuth
path Parameters
FunctionId
required
string

The functionId or name:{name}. In the 2nd case, if the named non-public function does not exist, the target will be a public function with the same name.

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "function": {
    }
}

Invoke Function

Authorizations:
Pipe17KeyAuth
path Parameters
FunctionId
required
string

The functionId or name:{name}. In the 2nd case, if the named non-public function does not exist, the target will be a public function with the same name.

Request Body schema:
input
object

The conversion input (- any value)

Responses

Request samples

Content type
{
  • "input": { }
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "input": { },
  • "value": { }
}

List Functions

Authorizations:
Pipe17KeyAuth
query Parameters
body
string

Select by body value or regexp of the body (regexp format - "/.../" or "/.../i")

count
integer <int32>
Default: 100

Return at most this many functions

functionId
Array of strings

Select by functionId list

isPublic
boolean

The true selects public functions only, false - non-public ones. By default, any of them.

keys
string
Default: "functionId,name,isPublic,body,createdAt,updatedAt,orgKey"

Return these top-level fields

name
Array of strings

Select by name list

order
string
Default: "name,isPublic"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Select functions created after this date-time

skip
integer <int32>
Default: 0

Skip this many functions

until
string <date-time>

Select functions created before this date-time

updatedSince
string <date-time>

Select functions updated after this date-time

updatedUntil
string <date-time>

Select functions updated before this date-time

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "functions": [
    ],
  • "pagination": {
    }
}

Update Function

  • Each public function has an unique name
  • Name of each non-public function is unique within organization
Authorizations:
Pipe17KeyAuth
path Parameters
FunctionId
required
string

The functionId or name:{name}. In the 2nd case, if the named non-public function does not exist, the target will be a public function with the same name.

query Parameters
keys
string
Default: ""

Fields of the updated object that should be returned (- comma separated string, "*" - all)

Request Body schema:
body
string

Body of javascript function. The function signature - function(input):any. Body example - "return input.toUpperCase()".

name
string

Name of the function

Responses

Request samples

Content type
{
  • "body": "string",
  • "name": "string"
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "function": {
    }
}

Convert

Convert a source object to target using specified mapping rules

Authorizations:
ApiKeyAuth
Request Body schema: application/json
required
object
source
required
object

Source object to convert

Responses

Request samples

Content type
application/json
{
  • "rules": {
    },
  • "source": { }
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "result": {
    }
}

Converter

Mapping rules based objects conversion

Convert a source object to target using specified mapping rules

Authorizations:
Pipe17KeyAuth
Request Body schema: application/json
required
object
source
required
object

Source object to convert

Responses

Request samples

Content type
application/json
{
  • "rules": {
    },
  • "source": { }
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "success": true,
  • "info": { },
  • "message": "string",
  • "result": {
    }
}

Lookup Objects

Provides an API for creating and maintaining a collection of abstract dictionaries intended for use either only within an individual organization (- "private dictionaries") or by all organizations (- "public dictionaries"). Dictionary is represented as a collection of "lookup objects". Field lookupType of a lookup object identifies the dictionary to which this object belongs (- understand this as the name of the dictionary). The boolean field isPublic indicates whether the dictionary is publicly available or not. To search a specified dictionary by an input string (- lookupKey), the API provides the lookup method. If the search in private dictionary fails, an attempt is made to find the matching object in the public dictionary of the same name.

Lookup Object Model

expression
required
string

Expression representing the lookup keys (lookupKey) that the object matches to. The format and meaning depend on the expressionType value.

expressionType
required
string (LookupObjectExpressionType)
Enum: "literal" "regexp" "function"

Type of the lookup keys expression (- expression):

  • "literal" - indicates the expression is exact value of matching key
  • "regexp" - indicates the expression is a regexp of matching keys (regexp string format: "/.../" or "/.../i")
  • "function" - indicates the expression is identifier of "conversion function" that returns some specific value (- not undefined & not null) when applied to the matching keys (identifier format: "{functionId}" or "name:{name}", see "Conversion Functions / Invoke Function")
lookupType
required
string

Type of the lookup object

createdAt
string <date-time>

When the object was created within Pipe17

hidden
boolean

Set the true to exclude the object from the responses to the "List Lookup Objects" queries (- the true value can only be applied to public objects).

isPublic
boolean

Public object indicator (default - false)

lookupId
string

Lookup Object ID

orgKey
string

Organization this object belong to

updatedAt
string <date-time>

When the object was updated within Pipe17

value
object

Lookup object value (- any type). It should be undefined in requests if expressionType is equal to "function". In the lookup query response, if a functional lookup-object is found as matching, the value returned by the conversion function will be set in the value field.

{
  • "lookupId": "string",
  • "expression": "string",
  • "expressionType": "literal",
  • "lookupType": "string",
  • "hidden": true,
  • "isPublic": true,
  • "value": { },
  • "createdAt": "2019-08-24T14:15:22Z",
  • "orgKey": "string",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Create Lookup Objects

Authorizations:
Pipe17KeyAuth
Request Body schema:
Array (<= 100 items)
expression
required
string

Expression representing the lookup keys (lookupKey) that the object matches to. The format and meaning depend on the expressionType value.

expressionType
required
string (LookupObjectExpressionType)
Enum: "literal" "regexp" "function"

Type of the lookup keys expression (- expression):

  • "literal" - indicates the expression is exact value of matching key
  • "regexp" - indicates the expression is a regexp of matching keys (regexp string format: "/.../" or "/.../i")
  • "function" - indicates the expression is identifier of "conversion function" that returns some specific value (- not undefined & not null) when applied to the matching keys (identifier format: "{functionId}" or "name:{name}", see "Conversion Functions / Invoke Function")
lookupType
required
string

Type of the lookup object

hidden
boolean

Set the true to exclude the object from the responses to the "List Lookup Objects" queries (- the true value can only be applied to public objects).

isPublic
boolean

Public object indicator (default - false)

value
object

Lookup object value (- any type). It should be undefined in requests if expressionType is equal to "function". In the lookup query response, if a functional lookup-object is found as matching, the value returned by the conversion function will be set in the value field.

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "lookupObjects": [
    ]
}

Delete Lookup Object

Authorizations:
Pipe17KeyAuth
path Parameters
LookupId
required
string

Lookup Object ID

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true
}

Fetch Lookup Object

Authorizations:
Pipe17KeyAuth
path Parameters
LookupId
required
string

Lookup Object ID

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "lookupObject": {
    }
}

List Lookup Objects

Authorizations:
Pipe17KeyAuth
query Parameters
count
integer <int32>
Default: 100

Return at most this many objects

expression
Array of strings

Select by expression list

expressionType
Array of strings

Select by expressionType list

isPublic
boolean

The true selects public objects only, false - non-public ones. By default, any of them.

keys
string
Default: "lookupId,lookupType,isPublic,expression,expressionType,value,createdAt,updatedAt,orgKey"

Return these top-level fields

lookupId
Array of strings

Select by lookupId list

lookupType
Array of strings

Select by lookupType list

order
string
Default: "orgKey,lookupType,expressionType,expression"

Sort by these top-level fields

pagination
string
Value: "disabled"

Exclude pagination info from the response

since
string <date-time>

Select objects created after this date-time (- ignored if the types parameter is set to true)

skip
integer <int32>
Default: 0

Skip this many objects

types
boolean

Set the true to return only lookupTypes array (default or false -- return lookupObjects array and optionally pagination)

until
string <date-time>

Select objects created before this date-time (- ignored if the types parameter is set to true)

updatedSince
string <date-time>

Select objects updated after this date-time (- ignored if the types parameter is set to true)

updatedUntil
string <date-time>

Select objects updated before this date-time (- ignored if the types parameter is set to true)

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "filters": {
    },
  • "lookupObjects": [
    ],
  • "lookupTypes": [
    ],
  • "pagination": {
    }
}

Lookup by string

Looks up an object matching to given string (- lookupKey) in the organization specific subcollection of lookup objects of specified type (- LookupType). If the organization's own object is not found, a lookup is performed for the matching public object (obj.isPublic). In any case, the lookup among literal objects (obj.expressionType=="literal", exact match to the lookup key) precedes the lookup among the objects that support regular expression matching (obj.expressionType=="regexp"). The functional lookup object (obj.expressionType=="function") is the last chance when neither a literal object nor a regexp one is found.

Authorizations:
Pipe17KeyAuth
path Parameters
LookupType
required
string

Type of the lookup objects

query Parameters
isPublic
boolean

The true limits search to public objects, false - to non-public ones. By default, not limited.

keys
string
Default: "lookupId,value"

Fields of the found object (if it is) that should be returned (- comma separated string, "*" - all)

lookupKey
required
string

Lookup key (- any string)

Responses

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "lookupKey": "string",
  • "lookupObject": {
    }
}

Update Lookup Object

Authorizations:
Pipe17KeyAuth
path Parameters
LookupId
required
string

Lookup Object ID

query Parameters
keys
string
Default: ""

Fields of the updated object that should be returned (- comma separated string, "*" - all)

Request Body schema:
expression
string

Expression representing the lookup keys (lookupKey) that the object matches to. The format and meaning depend on the expressionType value.

expressionType
string (LookupObjectExpressionType)
Enum: "literal" "regexp" "function"

Type of the lookup keys expression (- expression):

  • "literal" - indicates the expression is exact value of matching key
  • "regexp" - indicates the expression is a regexp of matching keys (regexp string format: "/.../" or "/.../i")
  • "function" - indicates the expression is identifier of "conversion function" that returns some specific value (- not undefined & not null) when applied to the matching keys (identifier format: "{functionId}" or "name:{name}", see "Conversion Functions / Invoke Function")
hidden
boolean

Set the true to exclude the object from the responses to the "List Lookup Objects" queries (- the true value can only be applied to public objects).

lookupType
string

Type of the lookup object

value
object or null

Lookup object value (- any type). Setting this field is not supported if the resulting expressionType is "function".

Responses

Request samples

Content type
{
  • "expression": "string",
  • "expressionType": "literal",
  • "hidden": true,
  • "lookupType": "string",
  • "value": { }
}

Response samples

Content type
{
  • "code": 200,
  • "success": true,
  • "lookupObject": {
    }
}

References

Entity field values

List distinct values of a field in entity collection

Authorizations:
Pipe17KeyAuth
query Parameters
field
required
string (EntityFieldRef)
Enum: "orders.orderSource" "products.sku" "products.integration" "products.vendor"

Entity field reference, in "entityType.fieldPath" format

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "success": true,
  • "values": [
    ],
  • "filters": {
    }
}