Venue API V1
This is a legacy API.
V3 is the actively maintained version. New integrations should use
Venue API V3
instead.
Info
1 endpoints-
GET
/api/{token}/v1/info
Endpoints
GET
/api/{token}/v1/info
Venue Info
Example
curl -X GET "https://app.posabit.com/api/YOUR_API_TOKEN/v1/info" \
-H "Accept: application/json"
Responses
| Status | Description |
|---|---|
| 200 | Success |
| 400 | Bad Request |
| 422 | Invalid parameters |
| 500 | Internal Server Error |
Coupons
1 endpoints-
GET
/api/{token}/v1/coupons
Endpoints
GET
/api/{token}/v1/coupons
Venue Coupons
Example
curl -X GET "https://app.posabit.com/api/YOUR_API_TOKEN/v1/coupons" \
-H "Accept: application/json"
Responses
| Status | Description |
|---|---|
| 200 | Success |
| 400 | Bad Request |
| 422 | Invalid parameters |
| 500 | Internal Server Error |
Incoming Orders
2 endpointsThe Online Orders page is where you can view and manage all of your incoming online orders. This page is designed to give you a better overview of all of your incoming orders in one place. You can easily see important information such as the order source, order status, and order details. Additionally, you can filter and sort through your orders to find exactly what you're looking for.
POST
/api/{token}/v1/incoming_orders
Create an incoming order
Example
curl -X POST "https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_orders" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"incoming_order": {
"order_type": "pickup",
"first_name": "John",
"last_name": "Doe",
"email": "test@posabit.com",
"telephone": "5551112222",
"address": "",
"city": "",
"state_abbrev": "",
"zipcode": "",
"reference_no": "12345-86-123",
"notes": "Gets free lighter",
"requested_payment_method": "cash",
"source": "online_store",
"order_items_attributes": [
{
"product_parent_id": "Treehawk Farms - Wifi OG Pre-Roll 2pk (1g)",
"product_id": 808542,
"quantity": 2
}
]
}
}'
Request Body
{
"incoming_order": {
"order_type": "pickup",
"first_name": "John",
"last_name": "Doe",
"email": "test@posabit.com",
"telephone": "5551112222",
"address": "",
"city": "",
"state_abbrev": "",
"zipcode": "",
"reference_no": "12345-86-123",
"notes": "Gets free lighter",
"requested_payment_method": "cash",
"source": "online_store",
"order_items_attributes": [
{
"product_parent_id": "Treehawk Farms - Wifi OG Pre-Roll 2pk (1g)",
"product_id": 808542,
"quantity": 2
}
]
}
}
Responses
| Status | Description |
|---|---|
| 400 | Bad Request |
| 422 | Invalid parameters |
| 500 | Internal Server Error |
GET
/api/{token}/v1/incoming_orders/{id}
Find an incoming order
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
id
|
integer | path | Yes |
Example
curl -X GET "https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_orders/{id}" \
-H "Accept: application/json"
Responses
| Status | Description |
|---|---|
| 200 | Success |
| 404 | Requested reference number or id not found |
| 422 | Invalid parameters |
| 500 | Internal Server Error |
Response Fields
| Field | Type | Required | Description |
|---|---|---|---|
reference_no
|
string | No | |
customer_type
|
string | No | Default: recreational |
terminal_id
|
integer | No | |
customer_id
|
integer | No | |
local_order_id
|
string | No | |
driver_id
|
integer | No | |
vehicle_id
|
integer | No | |
aasm_state
|
string | No | Default: pending |
pos_status
|
string | No | |
source
|
string(30) | No | Default: online_store |
first_name
|
string | No | |
last_name
|
string | No | |
telephone
|
string | No | |
email
|
string | No | |
processed_by
|
string | No | |
saved_order_data
|
text | No | |
created_at
|
datetime | Yes | |
updated_at
|
datetime | Yes | |
processed_at
|
datetime | No | |
order_type
|
string | No | Default: pickup |
requested_payment_method
|
string | No | |
address
|
string | No | Default: |
city
|
string | No | Default: |
state_abbrev
|
string | No | Default: |
zipcode
|
string | No | Default: |
country
|
string | No | Default: US |
lat
|
float | No | |
lng
|
float | No | |
notes
|
text | No | |
internal_notes
|
text | No | |
departured_at
|
datetime | No | |
delivered_at
|
datetime | No | |
requested_date
|
date | No | |
requested_window_start_time
|
string(100) | No | |
requested_window_end_time
|
string(100) | No | |
planned_route
|
text | No | |
delivery_status
|
string | No | |
sts_error
|
text | No | |
total
|
integer | No | |
tip_amount
|
integer | No | Default: 0 |
tip_type
|
string | No | |
created_by
|
string | No | |
status_callback
|
text | No | |
payment_prepaid
|
boolean | No | Default: false |
payment_source
|
string(80) | No | |
payment_reference_id
|
string(80) | No | |
payment_amount
|
integer | No | |
proc_time
|
integer | No | Default: 0 |
reason
|
string | No | |
payment_verified
|
boolean | No | Default: false |
curbside
|
boolean | No | Default: false |
third_party_request_id
|
integer | No | |
api_id
|
string(64) | No | |
cancellation_notes
|
text | No | |
external_error
|
text | No | |
payment_auth_id
|
string | No | |
refresh_token
|
string | No | |
token_expires_at
|
datetime | No | |
tip_calculated
|
integer | No | Default: 0 |
processing_fee
|
integer | No | Default: 0 |
ip
|
string | No | |
oauth_token
|
text | No | |
otp
|
string | No | |
client_type
|
string(20) | No | |
fulfillment_method
|
string(20) | No | |
fulfillment_sub_type
|
string(30) | No | |
integrator_id
|
integer | No | |
api_version
|
string(10) | No |
Response Example
{
"code": 1,
"incoming_order": {
"id": 19798,
"aasm_state": "processing",
"reference_no": "3221-1727814981-bb1314bf",
"first_name": "A",
"last_name": "A",
"source": "posabit_v2",
"order_type": "pickup",
"notes": null,
"delivered_at": null,
"requested_date": null,
"requested_window_start_time": {},
"requested_window_end_time": {},
"requested_payment_method": "cash",
"payment_verified": false,
"curbside": false,
"created_at": "2024-10-01T20:39:23.000Z",
"updated_at": "2024-10-01T20:41:19.000Z"
},
"order_items": [
{
"item_id": 32713,
"product_id": 800583,
"sku_id": 107907,
"manifest_item_id": null,
"product_name": "'oh' McDonald Farms - Nuken (1g)",
"product_brand": "'oh' McDonald Farms",
"product_strain": "Nuken",
"weight": "1.1g",
"quantity": 1,
"unit_quantity": "1.1",
"price": 1500,
"discount": 0,
"tax": 473,
"tier_weight_id": null,
"coupons": [],
"taxes": [],
"created_at": "2024-10-01T20:36:21.000Z",
"updated_at": "2024-10-01T20:36:21.000Z"
}
]
}
Incoming Quotes
4 endpoints
PUT
/api/{token}/v1/incoming_quotes/{id}/finalize
Finalize an incoming quote. Submits an Order.
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
id
|
integer | path | Yes |
Example
curl -X PUT "https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes/{id}/finalize" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{...}'
Responses
| Status | Description |
|---|---|
| 200 | Success |
| 204 | Record not found |
| 400 | Bad Request |
POST
/api/{token}/v1/incoming_quotes
Create an incoming quote
Example
curl -X POST "https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"quote": {
"incoming_order_id": null,
"venue_id": 3221,
"fulfillment": {
"source": "posabit_v2",
"order_type": "pickup",
"requested_date": null,
"requested_window_start_time": null,
"requested_window_end_time": null,
"tip_amount": 0,
"tip_type": null,
"processing_fee": 300,
"tip_calculated": 0,
"delivery_address": {
"address": "",
"city": "",
"state_abbrev": "",
"zipcode": ""
}
},
"customer": {
"first_name": "Jane",
"last_name": "Doe",
"email": "test@posabit.com",
"telephone": "5551112222",
"customer_type": "recreational"
},
"payment": {
"requested_payment_method": "cash"
},
"items": [
{
"sku_id": 107907,
"quantity": 1,
"product_id": 800583,
"name": "'oh' McDonald Farms - Nuken (1g)",
"unit_type": "g",
"unit": "1.1",
"variant_id": "k107907",
"quantity_on_hand": 30,
"test_results": {
"thc": {
"current": 4.2,
"low": 4.2,
"high": 4.2,
"unit_type": "%"
},
"cbd": {
"current": 10,
"low": 10,
"high": 10,
"unit_type": "%"
},
"thca": null,
"cbda": null,
"total_thc": {
"current": 4.2,
"low": 4.2,
"high": 4.2,
"unit_type": "%"
},
"total_cbd": null,
"thcv": null,
"cbdv": null,
"cbc": null,
"cbca": null,
"cbcv": null,
"cbn": null,
"cbg": null,
"cbga": null,
"cbgv": null
},
"terpene_results": [],
"product_image": {
"is_product_specific_image": true,
"lg": "https://pbit-staging.s3.amazonaws.com/images/image/210/large_image.jpg",
"md": "https://pbit-staging.s3.amazonaws.com/images/image/210/medium_image.jpg"
},
"discount": 0,
"price": 1500,
"discount_ids": []
}
]
}
}'
Request Body
{
"quote": {
"incoming_order_id": null,
"venue_id": 3221,
"fulfillment": {
"source": "posabit_v2",
"order_type": "pickup",
"requested_date": null,
"requested_window_start_time": null,
"requested_window_end_time": null,
"tip_amount": 0,
"tip_type": null,
"processing_fee": 300,
"tip_calculated": 0,
"delivery_address": {
"address": "",
"city": "",
"state_abbrev": "",
"zipcode": ""
}
},
"customer": {
"first_name": "Jane",
"last_name": "Doe",
"email": "test@posabit.com",
"telephone": "5551112222",
"customer_type": "recreational"
},
"payment": {
"requested_payment_method": "cash"
},
"items": [
{
"sku_id": 107907,
"quantity": 1,
"product_id": 800583,
"name": "'oh' McDonald Farms - Nuken (1g)",
"unit_type": "g",
"unit": "1.1",
"variant_id": "k107907",
"quantity_on_hand": 30,
"test_results": {
"thc": {
"current": 4.2,
"low": 4.2,
"high": 4.2,
"unit_type": "%"
},
"cbd": {
"current": 10,
"low": 10,
"high": 10,
"unit_type": "%"
},
"thca": null,
"cbda": null,
"total_thc": {
"current": 4.2,
"low": 4.2,
"high": 4.2,
"unit_type": "%"
},
"total_cbd": null,
"thcv": null,
"cbdv": null,
"cbc": null,
"cbca": null,
"cbcv": null,
"cbn": null,
"cbg": null,
"cbga": null,
"cbgv": null
},
"terpene_results": [],
"product_image": {
"is_product_specific_image": true,
"lg": "https://pbit-staging.s3.amazonaws.com/images/image/210/large_image.jpg",
"md": "https://pbit-staging.s3.amazonaws.com/images/image/210/medium_image.jpg"
},
"discount": 0,
"price": 1500,
"discount_ids": []
}
]
}
}
Responses
| Status | Description |
|---|---|
| 400 | Bad Request |
| 422 | Invalid parameters |
| 500 | Internal Server Error |
GET
/api/{token}/v1/incoming_quotes/{id}
Find an incoming quote
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
id
|
integer | path | Yes |
Example
curl -X GET "https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes/{id}" \
-H "Accept: application/json"
Responses
| Status | Description |
|---|---|
| 200 | Success |
| 404 | Requested reference number or id not found |
| 422 | Invalid parameters |
| 500 | Internal Server Error |
Response Fields
| Field | Type | Required | Description |
|---|---|---|---|
customer_type
|
string | No | Default: recreational |
reference_no
|
string | No | |
subtotal
|
integer | No | Default: 0 |
tax
|
integer | No | Default: 0 |
discount
|
integer | No | Default: 0 |
total
|
integer | No | Default: 0 |
tip_amount
|
integer | No | Default: 0 |
tip_type
|
string | No | |
created_at
|
datetime | Yes | |
updated_at
|
datetime | Yes | |
telephone
|
string | No | |
customer_id
|
integer | No | |
order_type
|
string | No | Default: pickup |
address
|
string | No | Default: |
city
|
string | No | Default: |
state_abbrev
|
string | No | Default: |
zipcode
|
string | No | Default: |
country
|
string | No | Default: US |
last_name
|
string | No | |
first_name
|
string | No | |
email
|
string | No | |
payment_source
|
string | No | |
requested_payment_method
|
string | No | |
source
|
string | No | Default: posabit_v2 |
requested_date
|
date | No | |
requested_window_start_time
|
time | No | |
requested_window_end_time
|
time | No | |
auto_apply_coupons
|
boolean | No | Default: false |
payment_auth_id
|
string | No | |
refresh_token
|
string | No | |
token_expires_at
|
datetime | No | |
tip_calculated
|
integer | No | Default: 0 |
processing_fee
|
integer | No | Default: 0 |
payment_amount
|
integer | No | Default: 0 |
notes
|
text | No | |
ip
|
string | No | |
oauth_token
|
text | No | |
otp
|
string | No | |
client_type
|
string(20) | No | |
fulfillment_method
|
string(20) | No | |
fulfillment_sub_type
|
string(30) | No | |
integrator_id
|
integer | No | |
api_version
|
string(10) | No |
Response Example
{
"code": 1,
"quote": {
"reference_no": "3221-1727814981-bb1314bf",
"incoming_order_id": null,
"venue_id": 3221,
"fulfillment": {
"source": "posabit_v2",
"order_type": "pickup",
"requested_date": null,
"requested_window_start_time": null,
"requested_window_end_time": null,
"tip_amount": 0,
"tip_type": null,
"processing_fee": 300,
"tip_calculated": 0,
"delivery_address": {
"address": "",
"city": "",
"state_abbrev": "",
"zipcode": ""
}
},
"customer": {
"first_name": "Jane",
"last_name": "Doe",
"email": "test@posabit.com",
"telephone": "5551111111",
"customer_type": "recreational"
},
"payment": {
"requested_payment_method": "cash"
},
"items": [
{
"sku_id": 107907,
"quantity": 1,
"product_id": 800583,
"name": "'oh' McDonald Farms - Nuken (1g)",
"unit_type": "g",
"unit": "1.1",
"variant_id": "k107907",
"quantity_on_hand": 30,
"test_results": {
"thc": {
"current": 4.2,
"low": 4.2,
"high": 4.2,
"unit_type": "%"
},
"cbd": {
"current": 10,
"low": 10,
"high": 10,
"unit_type": "%"
},
"thca": null,
"cbda": null,
"total_thc": {
"current": 4.2,
"low": 4.2,
"high": 4.2,
"unit_type": "%"
},
"total_cbd": null,
"thcv": null,
"cbdv": null,
"cbc": null,
"cbca": null,
"cbcv": null,
"cbn": null,
"cbg": null,
"cbga": null,
"cbgv": null
},
"terpene_results": [],
"product_image": {
"is_product_specific_image": true,
"lg": "https://pbit-staging.s3.amazonaws.com/images/image/210/large_image.jpg",
"md": "https://pbit-staging.s3.amazonaws.com/images/image/210/medium_image.jpg"
},
"discount": 0,
"price": 1500,
"discount_ids": []
}
],
"taxes": [],
"totals": {
"discount_ids": [],
"subtotal": 1500,
"discount": 0,
"tax": 473,
"total": 1500
},
"limits": {
"exceeded_limits": [],
"sum_per_limit": {
"recreational_flower": 1.1
}
}
}
}
PATCH
/api/{token}/v1/incoming_quotes/{id}
["Update an incoming quote", "Update an incoming quote items"]
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
id
|
integer | path | Yes | |
id
|
integer | path | Yes |
Example
curl -X PATCH "https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes/{id}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{...}'
Responses
| Status | Description |
|---|---|
| 200 | Success |
| 204 | Record not found |
| 400 | Bad Request |
| 200 | Success |
| 204 | Record not found |
| 400 | Bad Request |
Employees
1 endpointsEmployee management through the POSaBIT web portal allows you to easily create and manage all employees. This includes creating or changing their employee PIN number or adjusting their access level. Using the employee groups feature you can easily specify exactly how much access each employee should be given in the web portal.
-
GET
/api/v1/venue/employees
Endpoints
Models
GET
/api/v1/venue/employees
Get all users for a venue
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
page
|
integer | query | No | Page Number |
per_page
|
integer | query | No | Results per page (default 1000) |
q[updated_at_gt]
|
datestring | query | No | Limit results using ransack syntax (e.g. q[updated_at_gt]='2019-07-01' would return employees updated since 2019-07-01) |
Example
curl -X GET "https://app.posabit.com/api/v1/venue/employees" \
-H "Accept: application/json"
Responses
| Status | Description |
|---|---|
| 200 | Success |
| 401 | Unauthorized |
Models
Employee
An Employee.
| Property | Type | Required | Description |
|---|---|---|---|
id
|
integer | Yes | Employee Id |
first_name
|
string | No | First Name |
created_at
|
datetime | No | Created At |
updated_at
|
datetime | No | Updated At |
Customers
1 endpointsPOSaBIT offers custom profiles for each of your loyalty customers. With just the scan of the customer's ID, the point of sale pulls up the customer’s favorite types of products, displays their purchase history, shows their available loyalty points/rewards, and even has an area where you can easily make notes about the customer.
-
GET
/api/v1/venue/customers
Endpoints
Models
GET
/api/v1/venue/customers
Get all customers for a venue
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
page
|
integer | query | No | Page Number |
per_page
|
integer | query | No | Results per page (default 1000) |
q[updated_at_gt]
|
datestring | query | No | Filter results using ransack syntax (e.g. q[updated_at_gt]='2019-07-01' would return employees updated since 2019-07-01) |
Example
curl -X GET "https://app.posabit.com/api/v1/venue/customers" \
-H "Accept: application/json"
Responses
| Status | Description |
|---|---|
| 200 | Success |
| 401 | Unauthorized |
Response Fields
| Field | Type | Required | Description |
|---|---|---|---|
customer_type
|
string | No | Default: recreational |
active
|
boolean | No | Default: true |
gender
|
string(15) | No | |
loyalty
|
boolean | No | Default: false |
loyalty_number
|
string | No | |
customer_level_id
|
integer | No | |
points
|
integer | Yes | Default: 0 |
lifetime_points
|
integer | Yes | Default: 0 |
birthday
|
date | No | |
first_name
|
string | No | |
full_name
|
string | No | |
id_number
|
string | No | |
id_expiration
|
date | No | |
id_type
|
string | No | Default: drivers_license |
profile_image
|
string | No | |
last_name
|
string | No | |
telephone
|
string | No | |
created_at
|
datetime | No | |
updated_at
|
datetime | No | |
zipcode
|
string(10) | No | |
address
|
string | No | |
city
|
string | No | Default: |
apns
|
boolean | No | Default: false |
referral_code
|
string | No | Default: |
state
|
string | No | Default: |
email
|
string | No | |
was_first_created_on_pos
|
boolean | No | Default: false |
country
|
string(2) | No | Default: US |
sms_opt_out
|
boolean | No | Default: true |
status
|
string | No | |
employee_hire_date
|
date | No | |
medical_card
|
string | No | |
medical_card_exp
|
date | No | |
caregiver_id
|
string | No | |
caregiver_id_exp
|
date | No | |
loyalty_member_since
|
date | No | |
sms_reachable
|
boolean | Yes | Default: true |
sms_sent_at
|
datetime | No | |
coupons_count
|
integer | Yes | Default: 0 |
reviewed
|
boolean | No | Default: false |
terms_agreed
|
boolean | No | Default: false |
referral_source
|
string | No | |
ext_signature_src
|
string | No | |
certifying_provider
|
string | No | |
sms_opt_source
|
string | No | |
custom_allotment
|
string | No | |
medical_card_state
|
string | No | |
token
|
string | No | |
token_expires_at
|
datetime | No | |
medical_card_effective
|
date | No | |
core_token
|
string | No | |
one_time_pin
|
string | No | |
otp_expires_at
|
datetime | No | |
core_consumer_ref
|
string | No | |
last_online_login
|
datetime | No | |
online_account_created_at
|
datetime | No | |
sms_first_message_sent_at
|
datetime | No |
Response Example
{
"total_records": 475,
"current_page": 1,
"total_pages": 475,
"per_page": 1,
"customers": [
{
"customerId": 279159,
"firstName": "JANE",
"created_at": "2019-10-21T20:21:19.000Z",
"updated_at": "2021-10-05T19:31:24.000Z",
"birthyear": 1992,
"gender": "female",
"phone": "5551111111"
}
]
}
Models
Customer
An Employee.
| Property | Type | Required | Description |
|---|---|---|---|
customerId
|
integer | Yes | Customer Id |
first_name
|
string | No | First Name |
birthyear
|
string | No | Birth Year |
gender
|
string | No | Gender |
telephone
|
string | No | Telephone |
created_at
|
datetime | No | Created At |
updated_at
|
datetime | No | Updated At |
Inventories
1 endpointsThe default view of the inventory page will show you all of your active inventory, from lowest to highest number of units (or grams) on hand - this is so you can easily see which products are running low. Using the filters on the left side of the page, you can narrow down your search results by a particular product type, brand, supplier, etc.
-
GET
/api/v1/venue/inventories
Endpoints
GET
/api/v1/venue/inventories
Get all inventories for a venue
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
page
|
integer | query | No | Page Number |
per_page
|
integer | query | No | Results per page (default 1000) |
q[updated_at_gt]
|
datestring | query | No | Limit results using ransack syntax (e.g. q[updated_at_gt]='2019-07-01' would return employees updated since 2019-07-01) |
Example
curl -X GET "https://app.posabit.com/api/v1/venue/inventories" \
-H "Accept: application/json"
Responses
| Status | Description |
|---|---|
| 200 | Success |
| 401 | Unauthorized |
Response Fields
| Field | Type | Required | Description |
|---|---|---|---|
product_id
|
integer | Yes | |
tier_id
|
integer | No | |
barcode
|
string | No | |
price
|
integer | Yes | Default: 0 |
last_price
|
integer | No | |
cost
|
integer | Yes | Default: 0 |
discountable
|
boolean | Yes | Default: true |
quantity_on_hand
|
decimal | Yes | Default: 0.0 |
optimum_level
|
integer | No | Default: 0 |
reorder_threshold
|
integer | No | |
calc_threshold
|
integer | No | |
last_replenish_date
|
datetime | No | |
velocity
|
decimal | Yes | Default: 0.0 |
sold
|
integer | Yes | Default: 0 |
days_supply
|
integer | Yes | Default: 0 |
avg_cost
|
integer | No | |
avg_price
|
integer | No | |
sync_expires_at
|
datetime | No | |
last_order
|
datetime | No | |
created_at
|
datetime | No | |
updated_at
|
datetime | No | |
supplier_id
|
integer | No | |
updated_by
|
string | No | |
unit
|
string(15) | Yes | Default: units |
weight
|
decimal | Yes | Default: 0.0 |
weight_unit
|
string(15) | No | |
is_active
|
boolean | No | Default: true |
notes
|
text | No | |
sellable_quantity
|
decimal | Yes | Default: 0.0 |
ecomm_quantity
|
decimal | Yes | Default: 0.0 |
allow_undercost
|
boolean | Yes | Default: false |
manifest_items_count
|
integer | No | Default: 0 |
thc
|
decimal | No | |
cbd
|
decimal | No | |
cbn
|
decimal | No | |
equivalent_weight
|
decimal | No | |
equivalent_unit
|
string | No | |
thc_min
|
decimal | No | |
thc_max
|
decimal | No | |
cbd_min
|
decimal | No | |
cbd_max
|
decimal | No | |
cbn_min
|
decimal | No | |
cbn_max
|
decimal | No | |
api_id
|
string | No | |
inheritor_id
|
integer | No | |
med_price
|
integer | No | |
terpenes
|
text | No | |
manifest_transfer_date
|
date | No | |
thca
|
decimal | No | |
thca_min
|
decimal | No | |
thca_max
|
decimal | No | |
cbda
|
decimal | No | |
cbda_min
|
decimal | No | |
cbda_max
|
decimal | No | |
total_thc
|
decimal | No | |
total_thc_min
|
decimal | No | |
total_thc_max
|
decimal | No | |
producer_id
|
integer | No | |
doh_compliant
|
boolean | No | Default: false |
total_cbd
|
decimal | No | |
total_cbd_min
|
decimal | No | |
total_cbd_max
|
decimal | No | |
last_received_quantity
|
decimal | No | Default: 0.0 |
Response Example
{
"total_records": 1182,
"current_page": 1,
"total_pages": 1182,
"per_page": 1,
"products": [
{
"productId": 210111,
"internal_product_identifier": "800566",
"name": "High Five Farms - Ghost Train Haze",
"display_name": "Ghost Train Haze",
"unit": "280.0 gm",
"price": 1300,
"quantityInStock": "0.0",
"vendor": "High Five Farms",
"vendor_license": null,
"brand": "High Five Farms",
"category": "Bulk Flower",
"flowertype": "hybrid",
"concentratetype": null,
"producttype": "hybrid",
"productfamily": "Flower",
"tags": [
"Test Tag",
"Sale Day"
],
"description": "Conducive to concentration and creativity, this sati...",
"image": [
null
],
"active": false,
"bulkitem": true,
"strain": "Ghost Train Haze",
"thcMeasure": "0.0%",
"cbdMeasure": "0.0%",
"sku": "3264-902427",
"discountable": true,
"tier_name": "Top Tier",
"doh_compliant": false,
"effects": [
"Relaxed",
"Creative"
],
"flavors": [
"Flowery"
],
"rooms": [],
"created_at": "2019-10-16T20:37:49.000Z",
"updated_at": "2022-06-14T19:37:38.000Z"
}
]
}
Manifest Items
1 endpoints-
GET
/api/v1/venue/manifest_items
Endpoints
GET
/api/v1/venue/manifest_items
Get all manifest items for a venue
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
page
|
integer | query | No | Page Number |
per_page
|
integer | query | No | Results per page (default 1000) |
q[updated_at_gt]
|
datestring | query | No | Limit results using ransack syntax (e.g. q[updated_at_gt]='2019-07-01' would return employees updated since 2019-07-01) |
Example
curl -X GET "https://app.posabit.com/api/v1/venue/manifest_items" \
-H "Accept: application/json"
Responses
| Status | Description |
|---|---|
| 200 | Success |
| 401 | Unauthorized |
Response Fields
| Field | Type | Required | Description |
|---|---|---|---|
manifest_id
|
integer | No | |
sts_license_id
|
integer | No | |
lot_number
|
string | No | |
item_type
|
string | No | |
strain
|
string | No | |
name
|
text | No | |
description
|
text | No | |
expires_on
|
date | No | |
barcode
|
string | No | |
barcode_dupe
|
boolean | Yes | Default: false |
barcode_image
|
string | No | |
inventory_sku_id
|
integer | No | |
venue_room_id
|
integer | No | |
aasm_state
|
string | No | Default: pending |
position
|
integer | No | Default: 0 |
quantity
|
decimal | Yes | Default: 0.0 |
weight
|
decimal | Yes | Default: 0.0 |
net_weight
|
decimal | No | |
weight_unit
|
string(15) | No | Default: grams |
testing_lab
|
string | No | |
testing_date
|
datetime | No | |
testing_lab_license
|
string | No | |
test_results
|
text | No | |
test_contaminants_pass
|
boolean | No | |
test_cannabinoids_pass
|
boolean | No | |
test_pesticides_pass
|
boolean | No | |
thc
|
decimal | No | |
cbd
|
decimal | No | |
cbn
|
decimal | No | |
old_harvest_date
|
datetime | No | |
cost
|
integer | No | Default: 0 |
received_cost
|
integer | No | Default: 0 |
tax
|
integer | No | |
created_at
|
datetime | No | |
updated_at
|
datetime | No | |
last_sold
|
datetime | No | |
updated_by
|
string | No | |
is_sample
|
boolean | No | Default: false |
is_medical_only
|
boolean | No | Default: false |
ancestry
|
string | No | |
a_split
|
boolean | No | Default: false |
quantity_on_hand
|
decimal | Yes | Default: 0.0 |
api_id
|
string | No | |
received_quantity
|
decimal | Yes | Default: 0.0 |
batch_number
|
string | No | |
return_manifest_id
|
integer | No | |
pre_return_state
|
string | No | |
pre_return_quantity
|
decimal | No | |
custom_barcode_image
|
string | No | |
sample_type
|
string | No | |
product_sample_type
|
string | No | |
custom_barcode_image_version
|
string | No | |
transformed_from_id
|
integer | No | |
transformed_conversion
|
decimal | Yes | Default: 0.0 |
transformed_from_quantity
|
decimal | Yes | Default: 0.0 |
transformed_conversion_weight
|
string | No | |
original_sts_quantity
|
decimal | Yes | Default: 0.0 |
original_sts_unit
|
string | No | |
sts_quantity
|
decimal | No | |
sts_category
|
string | No | |
sts_state
|
string | No | |
sts_last_modified
|
string | No | |
quantity_adj
|
decimal | Yes | Default: 0.0 |
discrepancy_detected
|
datetime | No | |
last_audit
|
datetime | No | |
number_of_doses
|
decimal | No | |
coa_file
|
string | No | |
coa_url
|
text | No | |
excise_tax
|
integer | No | |
thca
|
decimal | No | |
cbda
|
decimal | No | |
total_thc
|
decimal | No | |
growth_method
|
string | No | |
total_terpene
|
decimal | No | |
weight_in_grams
|
decimal | No | |
cbc
|
decimal | No | |
cbg
|
decimal | No | |
cbga
|
decimal | No | |
cbca
|
decimal | No | |
cbgv
|
decimal | No | |
thcv
|
decimal | No | |
cbdv
|
decimal | No | |
cbcv
|
decimal | No | |
harvest_date
|
string | No | |
custom_field_1
|
string | No | |
custom_field_2
|
string | No | |
custom_field_3
|
string | No | |
accepted_date
|
date | No | |
sdp_category
|
string | No | |
sdp_compass
|
string | No | |
lab_result_link
|
text | No | |
doh_compliant
|
boolean | No | Default: false |
total_cbd
|
decimal | No | |
doh_type
|
string | No | |
has_unique_barcodes
|
boolean | No | Default: false |
Response Example
{
"total_records": 1325,
"current_page": 1,
"total_pages": 1325,
"per_page": 1,
"restocks": [
{
"restockId": 261876,
"parent_id": null,
"utcDate": "2019-10-16T20:37:49.000Z",
"quantity": "396.0",
"quantityInStock": "-1755.422",
"costPerUnit": 275,
"productId": 210111,
"inventoryId": "WAR414871.IN5SAJM",
"thcMeasure": "19.2%",
"cbdMeasure": "0.0%",
"created_at": "2019-10-16T20:37:49.000Z",
"updated_at": "2022-06-14T19:37:31.000Z"
}
]
}
Sales Histories
1 endpointsThe Sales window, is where you can see and sort through all of your previous transactions. Use the filters on the left side of the page to sort the transactions however you'd like. You can use this tab when looking for a return or if you'd like to dive into the details of a specific transaction.
-
GET
/api/v1/venue/sales_histories
Endpoints
GET
/api/v1/venue/sales_histories
Get all sales histories for a venue
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
page
|
integer | query | No | Page Number |
per_page
|
integer | query | No | Results per page (default 1000) |
q[updated_at_gt]
|
datestring | query | No | Limit results using ransack syntax (e.g. q[updated_at_gt]='2019-07-01' would return employees updated since 2019-07-01) |
Example
curl -X GET "https://app.posabit.com/api/v1/venue/sales_histories" \
-H "Accept: application/json"
Responses
| Status | Description |
|---|---|
| 200 | Success |
| 401 | Unauthorized |
Response Fields
| Field | Type | Required | Description |
|---|---|---|---|
order_type
|
string | No | Default: regular |
order_source
|
string | No | Default: walk_in |
incoming_order_id
|
integer | No | |
order_origin
|
string(30) | No | |
customer_id
|
integer | No | |
age
|
integer | No | |
gender
|
string | No | |
terminal_till_id
|
integer | No | |
order_id
|
integer | No | |
venue_name
|
string | No | |
customer_name
|
string | No | |
payment_source
|
string | No | |
payment_type
|
string | No | |
ordered_at
|
datetime | No | |
local_time
|
datetime | No | |
fulfilled_at
|
datetime | No | |
discount
|
integer | No | |
service_charge
|
integer | No | |
delivery_charge
|
integer | No | |
gratuity
|
integer | No | |
tax
|
integer | No | |
total
|
integer | No | |
open_credits
|
integer | No | |
restricted_credits
|
integer | No | |
promo_credits
|
integer | No | |
gopago_credits
|
integer | No | |
merchant_credits
|
integer | No | |
location
|
string | No | |
subtotal
|
integer | No | |
adjusted_time
|
datetime | No | |
venue_timezone
|
string | No | |
employee_name
|
string | No | |
status
|
string | No | |
local_order_id
|
string | No | |
fraction_of_day
|
string | No | |
bag_fee
|
integer | No | Default: 0 |
terminal_id
|
integer | No | |
tuid
|
string | No | |
order_discount
|
integer | No | Default: 0 |
pos_coupon_id
|
integer | No | |
pos_coupon_value
|
integer | No | |
cc_type
|
string | No | |
full_credit
|
integer | No | Default: 0 |
full_discount
|
integer | No | Default: 0 |
coupon_count
|
integer | Yes | Default: 0 |
created_at
|
datetime | Yes | |
updated_at
|
datetime | Yes | |
revisions
|
integer | Yes | Default: 0 |
description
|
string | No | |
proc_time
|
integer | No | Default: 0 |
cost
|
integer | No | Default: 0 |
sts_status
|
string | No | |
medical_card
|
string | No | |
medical_card_exp
|
date | No | |
api_id
|
string | No | |
breadcrumbs
|
text | No | |
is_caregiver
|
boolean | No | Default: false |
medical_card_effective
|
date | No | |
client_type
|
string(20) | No | |
fulfillment_method
|
string(20) | No | |
fulfillment_sub_type
|
string(30) | No | |
integrator_id
|
integer | No | |
api_version
|
string(10) | No | |
client_version
|
string | No |
Response Example
{
"total_records": 197,
"current_page": 1,
"total_pages": 197,
"per_page": 1,
"tickets": [
{
"ticketId": 49052949,
"isMedical": true,
"utcDate": "2022-01-14T23:52:34.000Z",
"localTime": "2022-01-14T15:52:34.000-08:00",
"ticketType": "sale",
"customerId": 279560,
"employeeId": 12777,
"paymentType": "",
"subTotal": 9498,
"discount": 1900,
"tax": 0,
"total": 7857,
"items": [
{
"ticketItemId": 91311967,
"ticketId": 49052949,
"productId": 318604,
"inventoryId": "WAR421642.INOLNTM",
"quantity": 1,
"weight": "1.0",
"cost": 800,
"subTotal": 2500,
"tax": 0,
"discount": 500,
"discountList": [
{
"couponId": 47831,
"couponName": "buy more than $30 of whatever"
}
],
"total": 2000
}
],
"created_at": "2022-01-14T23:52:36.000Z",
"updated_at": "2022-01-14T23:52:36.000Z"
}
]
}