InternalPurchaseOrder
InternalPurchaseOrder
List internal purchase orders for an organization
Reference to a tenant.
^[A-Za-z0-9-_]+
Reference to an organization.
^[A-Za-z0-9-_]+
Reference to a store uid
^[A-Za-z0-9-_]+
Reference to a store uid
^[A-Za-z0-9-_]+
Reference to a to-date-time
Reference to a from-date-time
Reference to a specific page in a result set.
The number of items per page in a result set.
Defines which field the resource list is sorted by.
ENUM | Description |
---|---|
ASC | Sort in ascending order |
DESC | Sort in descending order |
GET /v2/tenants/{tenantUid}/organizations/{organizationUid}/internal-purchase-orders HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Example response
{
"items": [
{
"createdAt": "2025-07-30T18:09:10.564Z",
"createdBy": "text",
"lastModifiedAt": "2025-07-30T18:09:10.564Z",
"lastModifiedBy": "text",
"shippedAt": "2025-07-30T18:09:10.564Z",
"shippedBy": "text",
"receivedAt": "2025-07-30T18:09:10.564Z",
"receivedBy": "text",
"sendingStoreUid": "text",
"receivingStoreUid": "text",
"note": "text",
"status": "NEW",
"trackingNumber": "text",
"items": [
{
"createdAt": "2025-07-30T18:09:10.564Z",
"createdBy": "text",
"lastModifiedAt": "2025-07-30T18:09:10.564Z",
"lastModifiedBy": "text",
"product": {
"productUid": "text",
"productName": "text",
"productSku": "text",
"coverImage": {
"productMediaUid": "text",
"mainUrl": "text",
"thumbnailUrl": "text"
},
"serialNoRequired": "NO"
},
"serialnumbers": [
"text"
],
"quantityOrdered": 1,
"shipFromWarehouseUid": "text",
"quantitySent": 1,
"quantityReceived": 1,
"receiveToWarehouseUid": "text",
"costPrice": 1,
"internalPurchaseOrderItemUid": "text"
}
],
"internalPurchaseOrderUid": "text",
"allowedStatuses": [
"NEW"
],
"internalPurchaseOrderNumber": "text",
"creatingStoreUid": "text"
}
],
"paging": {
"pageNumber": 1,
"pageSize": 1,
"totalCount": 1
}
}
sendingStoreUid
is the sender of the internal purchase order.
receivingStoreUid
is the receiver of the internal purchase order.
creatingStoreUid
is the store that creates the internal purchase order, which can be any of the above or another store.
If the creating store is not the sender, then the sender must confirm the request before the products on the order can be sent.
Reference to a tenant.
^[A-Za-z0-9-_]+
Reference to an organization.
^[A-Za-z0-9-_]+
^[A-Za-z0-9-_]+
^[A-Za-z0-9-_]+
^[A-Za-z0-9-_]+
ENUM | Description |
---|---|
NEW | Draft/work in progress |
READY_FOR_CONFIRMATION | The order is ready for confirmation by receiving store |
PREPARING_FOR_SHIPMENT | Internal purchase order is ready to be shipped from the sending store |
IN_TRANSIT | All quantity sent is registered and products are sent from sending store (and removed from warehouse) |
ARRIVED | Purchase order has arrived to requesting store and is ready for registering and controlling quantity |
COMPLETE | Purchase order is complete (and stock is added to the receiving stores warehouse) |
CANCELLED | Purchase order is cancelled. |
^[A-Za-z0-9-_]+
POST /v2/tenants/{tenantUid}/organizations/{organizationUid}/internal-purchase-orders HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 328
{
"sendingStoreUid": "text",
"receivingStoreUid": "text",
"internalPurchaseOrderUid": "text",
"items": [
{
"quantityOrdered": 1,
"costPrice": 1,
"internalPurchaseOrderItemUid": "text",
"productUid": "text"
}
],
"note": "text",
"status": "NEW",
"creatingStoreUid": "text",
"autoOrderProposal": {
"sendingWarehouseUid": "text",
"receivingWarehouseUid": "text"
}
}
Example response
{
"createdAt": "2025-07-30T18:09:10.564Z",
"createdBy": "text",
"lastModifiedAt": "2025-07-30T18:09:10.564Z",
"lastModifiedBy": "text",
"shippedAt": "2025-07-30T18:09:10.564Z",
"shippedBy": "text",
"receivedAt": "2025-07-30T18:09:10.564Z",
"receivedBy": "text",
"sendingStoreUid": "text",
"receivingStoreUid": "text",
"note": "text",
"status": "NEW",
"trackingNumber": "text",
"items": [
{
"createdAt": "2025-07-30T18:09:10.564Z",
"createdBy": "text",
"lastModifiedAt": "2025-07-30T18:09:10.564Z",
"lastModifiedBy": "text",
"product": {
"productUid": "text",
"productName": "text",
"productSku": "text",
"coverImage": {
"productMediaUid": "text",
"mainUrl": "text",
"thumbnailUrl": "text"
},
"serialNoRequired": "NO"
},
"serialnumbers": [
"text"
],
"quantityOrdered": 1,
"shipFromWarehouseUid": "text",
"quantitySent": 1,
"quantityReceived": 1,
"receiveToWarehouseUid": "text",
"costPrice": 1,
"internalPurchaseOrderItemUid": "text"
}
],
"internalPurchaseOrderUid": "text",
"allowedStatuses": [
"NEW"
],
"internalPurchaseOrderNumber": "text",
"creatingStoreUid": "text"
}
Get internal purchase order details
Reference to a tenant.
^[A-Za-z0-9-_]+
Reference to an organization.
^[A-Za-z0-9-_]+
Reference to an internal purchase order.
^[A-Za-z0-9-_]+
GET /v2/tenants/{tenantUid}/organizations/{organizationUid}/internal-purchase-orders/{internalPurchaseOrderUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Example response
{
"createdAt": "2025-07-30T18:09:10.564Z",
"createdBy": "text",
"lastModifiedAt": "2025-07-30T18:09:10.564Z",
"lastModifiedBy": "text",
"shippedAt": "2025-07-30T18:09:10.564Z",
"shippedBy": "text",
"receivedAt": "2025-07-30T18:09:10.564Z",
"receivedBy": "text",
"sendingStoreUid": "text",
"receivingStoreUid": "text",
"note": "text",
"status": "NEW",
"trackingNumber": "text",
"items": [
{
"createdAt": "2025-07-30T18:09:10.564Z",
"createdBy": "text",
"lastModifiedAt": "2025-07-30T18:09:10.564Z",
"lastModifiedBy": "text",
"product": {
"productUid": "text",
"productName": "text",
"productSku": "text",
"coverImage": {
"productMediaUid": "text",
"mainUrl": "text",
"thumbnailUrl": "text"
},
"serialNoRequired": "NO"
},
"serialnumbers": [
"text"
],
"quantityOrdered": 1,
"shipFromWarehouseUid": "text",
"quantitySent": 1,
"quantityReceived": 1,
"receiveToWarehouseUid": "text",
"costPrice": 1,
"internalPurchaseOrderItemUid": "text"
}
],
"internalPurchaseOrderUid": "text",
"allowedStatuses": [
"NEW"
],
"internalPurchaseOrderNumber": "text",
"creatingStoreUid": "text"
}
Update an internal purchase order
Reference to a tenant.
^[A-Za-z0-9-_]+
Reference to an organization.
^[A-Za-z0-9-_]+
Reference to an internal purchase order.
^[A-Za-z0-9-_]+
ENUM | Description |
---|---|
NEW | Draft/work in progress |
READY_FOR_CONFIRMATION | The order is ready for confirmation by receiving store |
PREPARING_FOR_SHIPMENT | Internal purchase order is ready to be shipped from the sending store |
IN_TRANSIT | All quantity sent is registered and products are sent from sending store (and removed from warehouse) |
ARRIVED | Purchase order has arrived to requesting store and is ready for registering and controlling quantity |
COMPLETE | Purchase order is complete (and stock is added to the receiving stores warehouse) |
CANCELLED | Purchase order is cancelled. |
PUT /v2/tenants/{tenantUid}/organizations/{organizationUid}/internal-purchase-orders/{internalPurchaseOrderUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 54
{
"note": "text",
"status": "NEW",
"trackingNumber": "text"
}
Example response
{
"createdAt": "2025-07-30T18:09:10.564Z",
"createdBy": "text",
"lastModifiedAt": "2025-07-30T18:09:10.564Z",
"lastModifiedBy": "text",
"shippedAt": "2025-07-30T18:09:10.564Z",
"shippedBy": "text",
"receivedAt": "2025-07-30T18:09:10.564Z",
"receivedBy": "text",
"sendingStoreUid": "text",
"receivingStoreUid": "text",
"note": "text",
"status": "NEW",
"trackingNumber": "text",
"items": [
{
"createdAt": "2025-07-30T18:09:10.564Z",
"createdBy": "text",
"lastModifiedAt": "2025-07-30T18:09:10.564Z",
"lastModifiedBy": "text",
"product": {
"productUid": "text",
"productName": "text",
"productSku": "text",
"coverImage": {
"productMediaUid": "text",
"mainUrl": "text",
"thumbnailUrl": "text"
},
"serialNoRequired": "NO"
},
"serialnumbers": [
"text"
],
"quantityOrdered": 1,
"shipFromWarehouseUid": "text",
"quantitySent": 1,
"quantityReceived": 1,
"receiveToWarehouseUid": "text",
"costPrice": 1,
"internalPurchaseOrderItemUid": "text"
}
],
"internalPurchaseOrderUid": "text",
"allowedStatuses": [
"NEW"
],
"internalPurchaseOrderNumber": "text",
"creatingStoreUid": "text"
}
Delete an internal purchase order
Reference to a tenant.
^[A-Za-z0-9-_]+
Reference to an organization.
^[A-Za-z0-9-_]+
Reference to an internal purchase order.
^[A-Za-z0-9-_]+
DELETE /v2/tenants/{tenantUid}/organizations/{organizationUid}/internal-purchase-orders/{internalPurchaseOrderUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No Content
No content
List all items on an internal purchase order
Reference to a tenant.
^[A-Za-z0-9-_]+
Reference to an organization.
^[A-Za-z0-9-_]+
Reference to an internal purchase order.
^[A-Za-z0-9-_]+
Reference to a specific page in a result set.
The number of items per page in a result set.
Defines which field the resource list is sorted by.
ENUM | Description |
---|---|
ASC | Sort in ascending order |
DESC | Sort in descending order |
GET /v2/tenants/{tenantUid}/organizations/{organizationUid}/internal-purchase-orders/{internalPurchaseOrderUid}/items HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Example response
{
"items": [
{
"createdAt": "2025-07-30T18:09:10.564Z",
"createdBy": "text",
"lastModifiedAt": "2025-07-30T18:09:10.564Z",
"lastModifiedBy": "text",
"product": {
"productUid": "text",
"productName": "text",
"productSku": "text",
"coverImage": {
"productMediaUid": "text",
"mainUrl": "text",
"thumbnailUrl": "text"
},
"serialNoRequired": "NO"
},
"serialnumbers": [
"text"
],
"quantityOrdered": 1,
"shipFromWarehouseUid": "text",
"quantitySent": 1,
"quantityReceived": 1,
"receiveToWarehouseUid": "text",
"costPrice": 1,
"internalPurchaseOrderItemUid": "text"
}
],
"paging": {
"pageNumber": 1,
"pageSize": 1,
"totalCount": 1
}
}
Create an order item on an internal purchase order
Reference to a tenant.
^[A-Za-z0-9-_]+
Reference to an organization.
^[A-Za-z0-9-_]+
Reference to an internal purchase order.
^[A-Za-z0-9-_]+
^[A-Za-z0-9-_]+
^[A-Za-z0-9-_]+
POST /v2/tenants/{tenantUid}/organizations/{organizationUid}/internal-purchase-orders/{internalPurchaseOrderUid}/items HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 93
{
"quantityOrdered": 1,
"costPrice": 1,
"internalPurchaseOrderItemUid": "text",
"productUid": "text"
}
Example response
{
"createdAt": "2025-07-30T18:09:10.564Z",
"createdBy": "text",
"lastModifiedAt": "2025-07-30T18:09:10.564Z",
"lastModifiedBy": "text",
"product": {
"productUid": "text",
"productName": "text",
"productSku": "text",
"coverImage": {
"productMediaUid": "text",
"mainUrl": "text",
"thumbnailUrl": "text"
},
"serialNoRequired": "NO"
},
"serialnumbers": [
"text"
],
"quantityOrdered": 1,
"shipFromWarehouseUid": "text",
"quantitySent": 1,
"quantityReceived": 1,
"receiveToWarehouseUid": "text",
"costPrice": 1,
"internalPurchaseOrderItemUid": "text"
}
Get internal purchase order item details
Reference to a tenant.
^[A-Za-z0-9-_]+
Reference to an organization.
^[A-Za-z0-9-_]+
Reference to an internal purchase order.
^[A-Za-z0-9-_]+
Reference to an internal purchase order item.
^[A-Za-z0-9-_]+
GET /v2/tenants/{tenantUid}/organizations/{organizationUid}/internal-purchase-orders/{internalPurchaseOrderUid}/items/{internalPurchaseOrderItemUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Example response
{
"createdAt": "2025-07-30T18:09:10.564Z",
"createdBy": "text",
"lastModifiedAt": "2025-07-30T18:09:10.564Z",
"lastModifiedBy": "text",
"product": {
"productUid": "text",
"productName": "text",
"productSku": "text",
"coverImage": {
"productMediaUid": "text",
"mainUrl": "text",
"thumbnailUrl": "text"
},
"serialNoRequired": "NO"
},
"serialnumbers": [
"text"
],
"quantityOrdered": 1,
"shipFromWarehouseUid": "text",
"quantitySent": 1,
"quantityReceived": 1,
"receiveToWarehouseUid": "text",
"costPrice": 1,
"internalPurchaseOrderItemUid": "text"
}
Update internal purchase order item details
Reference to a tenant.
^[A-Za-z0-9-_]+
Reference to an organization.
^[A-Za-z0-9-_]+
Reference to an internal purchase order.
^[A-Za-z0-9-_]+
Reference to an internal purchase order item.
^[A-Za-z0-9-_]+
^[A-Za-z0-9-_]+
PUT /v2/tenants/{tenantUid}/organizations/{organizationUid}/internal-purchase-orders/{internalPurchaseOrderUid}/items/{internalPurchaseOrderItemUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 80
{
"productUid": "text",
"quantityOrdered": 1,
"serialnumbers": [
"text"
],
"costPrice": 1
}
Example response
{
"createdAt": "2025-07-30T18:09:10.564Z",
"createdBy": "text",
"lastModifiedAt": "2025-07-30T18:09:10.564Z",
"lastModifiedBy": "text",
"product": {
"productUid": "text",
"productName": "text",
"productSku": "text",
"coverImage": {
"productMediaUid": "text",
"mainUrl": "text",
"thumbnailUrl": "text"
},
"serialNoRequired": "NO"
},
"serialnumbers": [
"text"
],
"quantityOrdered": 1,
"shipFromWarehouseUid": "text",
"quantitySent": 1,
"quantityReceived": 1,
"receiveToWarehouseUid": "text",
"costPrice": 1,
"internalPurchaseOrderItemUid": "text"
}
Delete an internal purchase order item
Reference to a tenant.
^[A-Za-z0-9-_]+
Reference to an organization.
^[A-Za-z0-9-_]+
Reference to an internal purchase order.
^[A-Za-z0-9-_]+
Reference to an internal purchase order item.
^[A-Za-z0-9-_]+
DELETE /v2/tenants/{tenantUid}/organizations/{organizationUid}/internal-purchase-orders/{internalPurchaseOrderUid}/items/{internalPurchaseOrderItemUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No Content
No content
Update an internal purchase order item with a send-quantity
Reference to a tenant.
^[A-Za-z0-9-_]+
Reference to an organization.
^[A-Za-z0-9-_]+
Reference to an internal purchase order.
^[A-Za-z0-9-_]+
Reference to an internal purchase order item.
^[A-Za-z0-9-_]+
- quantitySent: Quantity to send from wrehouse
- warehouseUid: warehouse to send stock from
quantity to send from warehouse
^[A-Za-z0-9-_]+
PUT /v2/tenants/{tenantUid}/organizations/{organizationUid}/internal-purchase-orders/{internalPurchaseOrderUid}/items/{internalPurchaseOrderItemUid}/send HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 73
{
"quantitySent": 1,
"serialnumbers": [
"text"
],
"shipFromWarehouseUid": "text"
}
Example response
{
"createdAt": "2025-07-30T18:09:10.564Z",
"createdBy": "text",
"lastModifiedAt": "2025-07-30T18:09:10.564Z",
"lastModifiedBy": "text",
"product": {
"productUid": "text",
"productName": "text",
"productSku": "text",
"coverImage": {
"productMediaUid": "text",
"mainUrl": "text",
"thumbnailUrl": "text"
},
"serialNoRequired": "NO"
},
"serialnumbers": [
"text"
],
"quantityOrdered": 1,
"shipFromWarehouseUid": "text",
"quantitySent": 1,
"quantityReceived": 1,
"receiveToWarehouseUid": "text",
"costPrice": 1,
"internalPurchaseOrderItemUid": "text"
}
Update an internal purchase order item with a receive-quantity
Reference to a tenant.
^[A-Za-z0-9-_]+
Reference to an organization.
^[A-Za-z0-9-_]+
Reference to an internal purchase order.
^[A-Za-z0-9-_]+
Reference to an internal purchase order item.
^[A-Za-z0-9-_]+
- quantityReceived: Quantity to receive to wrehouse
- warehouseUid: warehouse to receive stock
PUT /v2/tenants/{tenantUid}/organizations/{organizationUid}/internal-purchase-orders/{internalPurchaseOrderUid}/items/{internalPurchaseOrderItemUid}/receive HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 53
{
"quantityReceived": 1,
"receiveToWarehouseUid": "text"
}
Example response
{
"createdAt": "2025-07-30T18:09:10.564Z",
"createdBy": "text",
"lastModifiedAt": "2025-07-30T18:09:10.564Z",
"lastModifiedBy": "text",
"product": {
"productUid": "text",
"productName": "text",
"productSku": "text",
"coverImage": {
"productMediaUid": "text",
"mainUrl": "text",
"thumbnailUrl": "text"
},
"serialNoRequired": "NO"
},
"serialnumbers": [
"text"
],
"quantityOrdered": 1,
"shipFromWarehouseUid": "text",
"quantitySent": 1,
"quantityReceived": 1,
"receiveToWarehouseUid": "text",
"costPrice": 1,
"internalPurchaseOrderItemUid": "text"
}
Download internal purchase order.
Reference to a tenant.
^[A-Za-z0-9-_]+
Reference to an organization.
^[A-Za-z0-9-_]+
Reference to an internal purchase order.
^[A-Za-z0-9-_]+
GET /v2/tenants/{tenantUid}/organizations/{organizationUid}/internal-purchase-orders/{internalPurchaseOrderUid}/download HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Based on the Accept header the response will be base64 json encoded or a raw file. application/octet-stream will return a binary file application/json will return a json with the file content base64 encoded.
{
"content": "text",
"contentType": "text",
"filename": "text"
}
Was this helpful?