Error codes

Every response carries a code. 0 means success and anything else is an error. Dispatch on it rather than on the HTTP status: the code is stable, while the message text may be reworded.

The messages field carries the same explanation in every locale, so you never need a second request to show one.

Code	Message
0	Success
10000	Unknown error
10001	Validation error
10002	Invalid upload type
10003	You do not have permission to perform this action
10004	Unauthorized
10005	Your session has expired. Please log in again
10006	Too many requests
10007	Not found
10008	Conflict
10009	Idempotency mismatch
10010	Too many requests
10011	Request is in progress
10012	X-Audit-Reason header is required for this action
10013	Two-factor authentication required
10014	Invalid or expired 2FA code
10015	2FA is not enrolled
10016	File is too large. The maximum size is MB.
10018	Session could not be refreshed. Please log in again
10019	Session revoked. Please log in again
11000	User error
11001	User not found
11002	Email already in use
11003	Wrong phone, email or password
11004	Account deletion is already scheduled
11005	No account deletion is scheduled
11006	This account has already been erased
11007	This account is scheduled for deletion and cannot be given a credential
11008	Session not found
11009	This is the session you are using. Sign out to end it
11010	Your session could not be confirmed. Please sign in again
11011	You are the only owner of a shop. Add another owner before deleting your account
12000	Organization error
12001	Organization not found
12002	Organization is suspended
12003	A company is already registered with this phone number or email address
12009	The selected location is outside Uzbekistan — drop the pin on the branch address
12010	These fields are managed by a connected external system and cannot be edited here:
12011	Products for this organization are managed by a connected external system and cannot be created here
12012	Your role does not grant ""
12013	This company name is not allowed. Please choose another name.
12014	You do not have access to this branch
12015	Only a suspended or rejected organization can be deleted
12016	This organization still has card holds or refunds in progress
12017	The confirmation does not match the organization name
12018	Unknown business kind
12019	Ready products are unavailable right now
12020	Starter category not found
12021	Choose what the shop sells first
12022	Ready products were already added to this shop
12023	Choose at most ready products
13000	Category error
13001	Category not found
14000	Product error
14001	Product not found
14002	SKU already in use
14003	Product is inactive
14004	Only a member with access to every branch can change:
14005	You do not have permission to change the cost price
14006	A product can have at most 10 extra barcodes
14007	Set a price for this product before selling it
14008	Change the unit only when the product has no stock and no unfinished orders, counts, transfers or incomings ()
14009	Another product in this shop already uses this scale code
14010	A scale code can be set only on a product sold by weight
15000	Order error
15001	Order not found
15002	This order can’t move to that status right now
15003	Order is empty
15004	Some items are not available in the required quantity at this branch
15005	No nearby branch can fulfil this delivery
15006	A delivery location is required for delivery orders
15007	Selected branch is not available
15008	This order can no longer be cancelled — the shop has already accepted it
15009	All branch portions must arrive before the order is ready for pickup
15010	An order cannot be placed until this account has a verified phone number.
15011	This shop cannot accept this order at the moment.
15012	This order could not be confirmed just now — please try again in a moment.
15013	This order was recorded outside Bione and cannot be changed here.
15014	This sale names products that do not belong to this organization.
15015	This order belongs to another branch — only its portion from your branch can be changed here.
15016	Record how this order was paid: it is settled with its payment parts.
15017	This order is already paid.
15018	This order is paid — refund it to return the money and the stock.
15019	Record the payment before handing this order over — or leave it on credit.
16000	Customer error
16001	Insufficient cashback balance
16002	Cashback applied exceeds order subtotal
16003	Cashback tier not found
16005	customer(s) are currently on this tier. Adjust thresholds or wait for them to move before deleting.
16008	Adjustment amount must not be zero
16009	A reason is required for cashback adjustments
16010	Cannot adjust cashback for a customer with no linked account
16011	At least one of phone or email is required to invite a customer
16012	A customer with this phone or email already exists in your organization
16013	This person has already joined your loyalty programme
16014	This phone number does not belong to a Bione account. Invite them by email instead
16015	This customer manages their phone in the Bione app, so the shop cannot change it
16016	Another customer already has this phone number
17000	Review error
17001	Review not found
18000	Audit error
19001	Too many OTP requests. Try again in 60 seconds
19002	Invalid OTP code
19003	OTP code has expired
19004	Too many incorrect attempts. Request a new code
19005	Google authentication failed
19006	Telegram authentication failed
19008	Apple authentication failed
19009	Phone verification is currently unavailable. Use another sign-in method
20006	First and last name are required when inviting someone who has no Bione account yet
20007	That role does not belong to this organization
21000	Organization category error
21001	Organization category not found
21002	Parent category not found
21003	Organization categories can be at most 3 levels deep
21004	This category has organizations assigned to it and cannot receive child categories
21005	This category is assigned to one or more organizations and cannot be deleted until they are re-classified
21006	Only leaf categories (with no children) can be assigned to an organization
23001	A tax classification is required for this product
23002	A valid package must be selected for this classification
23003	Tax settings not found
23004	A default classification is required to apply it to all products
23005	Tasnif is currently unavailable — please try again
25000	Integration error
25001	This price list is not priced in so‘m and cannot be used
25002	Products measured in "" need a Bione unit that allows decimal places or more
25003	This warehouse does not allow sales and cannot supply a branch
25004	This external organization is already mapped to a different branch
25005	No external system is connected
25006	The selected record was not found
25007	This is not a sale price list and cannot be used
25008	This branch is already mapped to a different external organization
25009	Bione’s access to the connected system has expired. Reconnect to authorize it again
25010	The connected system could not be reached. Try again shortly
25011	This external account is already connected to another organization. Disconnect it there first
26002	This organization already has a role called ""
26004	This role is still assigned to employee(s). Move them to another role first.
26005	"" is not a known permission
27001	Discount not found
27002	This discount overlaps other discounts on the same products or categories; confirm to save it anyway
27003	Discounts for this organization are managed by a connected external system and cannot be changed here
27004	Order-amount discounts are not available for this organization
27005	A discount must have an end date later than its start date
27006	The discount value is invalid: a percent must be above 0 and at most 100, and an amount must be above 0
27007	This discount can no longer be changed this way
27008	Prices have changed since you confirmed. Please review the new amounts
27009	The order total is zero, so it cannot be paid by card. Choose another payment method
28001	Promo code not found
28002	A promo code can only use a discount of this shop that is marked "only with a promo code"
28003	This promo code is already used by another code in your shop
28004	A promo code must be 3 to 32 letters and digits
28005	What this promo code grants can no longer be changed because it has already been used
28006	Promo codes can only be applied by customers in their own app
28007	This audience is too large to issue personal codes to at once
28008	Too many attempts. Please try again later
28009	This phone number belongs to another account
28010	These promo code settings are not valid
28011	Live promo codes use this discount, so it cannot be made public
28012	The code is wrong or has expired
28013	This account already has a verified phone number
29001	This app is not registered for push on this server
29002	An iOS device must name its APNs environment
30001	You do not have permission to give discounts on a sale
30002	You do not have permission to set your own price on a sale
30003	A discount or price cannot make the sale cost less than zero
30004	A discount or price refers to a product that is not in this sale
30005	A sale line can have only one discount or price change
30006	The discount value is invalid: give either an amount above 0 or a percent above 0 and at most 100
30007	Cashback cannot pay for more than the sale costs
30008	The cashback amount is invalid
30009	The payments do not add up to the amount due
30010	Add how the sale was paid
30011	Only a cash payment can have an amount handed over
30012	The cash handed over is less than the cash payment
30013	A sale can have only one cash payment
30014	Each payment must be an amount above 0
30015	A sale can be paid only by cash, card terminal or card transfer
30016	The scanned code belongs to a different customer than the one selected
30017	Scan the customer's code to pay with their cashback
30018	Attach a customer to use a promo code
30019	The customer was not found
30020	The customer's code is invalid or has expired. Ask them to show a new one
30021	The refund parts do not add up to the amount due back
30022	The refund parts are invalid: use cash, card terminal or card transfer, each once, with an amount above zero
30023	Choose a reason or write a note for the return
30024	This till is not registered
30025	The offline sale was not found
30026	This offline sale has already been dealt with
30027	Send your own offline sales from the till; hand-over is for other members' sales
30028	Offline selling is not available right now
30029	That page of the offline catalogue does not exist
30031	Paying in the app is for orders, not a sale
30032	Payment is taken only when the order is paid now
30033	Paying in the app needs a customer
30034	This shop's accounting takes one payment method per order
30035	An order paid later needs a customer in this shop
30036	Finish or cancel the open orders before choosing Sales only
30037	Online ordering stays off while the shop sells in person only
30038	Some products are not sold at this branch
31001	This employee has no active access key
31002	This employee cannot work at this branch
31003	You cannot issue an access key to someone who has permissions you do not have
31004	The access key is not valid
31005	Access keys can only be used in the Bione merchant app
31006	This is not available when signed in with an access key
31007	This access key session has ended. Sign in with the access key again
32001	This printer's settings are not valid
32002	Printer not found
32003	A printer cannot be moved to another branch. Delete it and add it at the other branch
33001	A sale on credit needs a customer
33002	You are not allowed to sell on credit
33003	The payment covers the whole total, so nothing is left on credit
33004	This customer needs a phone number before they can buy on credit
33005	Debt not found
33006	The amount is more than the customer owes
33007	What the customer owes has changed. Check the amounts and try again
33008	This shop records debts in its accounting system, not by hand here
33009	The payment parts do not add up to the amount
33010	The accounting system refused this payment. Nothing was recorded; try again later
33011	The accounting system could not be reached. Nothing was recorded; try again
33012	This customer cannot be reached in Telegram. Share the reminder instead
33013	This customer owes nothing
33014	A reminder was already sent today. Try again later
33015	Could not confirm the reminder was sent
34001	This shop's operations are managed in its accounting system, not here
34002	An incoming with an unpaid amount needs a supplier
34003	The amount paid now is more than the incoming's total
34004	A product can appear only once in an incoming
34005	This incoming can no longer be cancelled because its goods or debt have moved. Use a supplier return instead
34006	An incoming recorded at the till cannot be paid there. Leave the amount paid now at zero
34007	Incoming not found
35001	Supplier not found
35002	A supplier with this name already exists
35003	This supplier is archived
35004	This supplier is still owed money. Pay what is owed before archiving them
35005	The amount is more than the shop owes this supplier
35006	What the shop owes this supplier has changed. Check the amounts and try again
35007	More units are being returned than remain from this incoming
35008	Only goods from an incoming with a supplier can be returned to a supplier
35009	Write a note to explain the reason for this return
36001	Some products are being counted at this branch. Try again when the count is finished
36002	This document is already closed
36003	Count at least one product before applying the count
36004	This write-off can no longer be cancelled
36005	A transfer must go to a different branch
36006	Write a note to explain the reason
36007	A product can appear only once in a document
36008	Document not found
36009	The stock of this product changed while it was being counted. Check it and count again
37001	Record not found
37002	Category not found
37003	This category is archived
37004	A category with this name already exists
37005	This category cannot be archived
37006	At the till, only cash expenses can be recorded
37007	Choose a period of at most 400 days
38001	Delivery is not available yet. Choose pickup
38002	This shop is not taking online orders right now
38003	This shop can't take your online order right now
38004	A shop can have at most five banners
38005	Banner not found
38006	Telegram did not accept this bot token. Copy it again from @BotFather
38007	This bot is already connected. Disconnect it first
38008	This bot is already used by another service. Confirm to move it to Bione
38009	No bot is connected to this shop
38010	Connecting a shop bot is not available right now
38011	Block not found
38012	This customer has no Bione account, so they cannot order online
38013	Write a note for this reason
39001	Not found
40001	Category not found
40002	A category with this name already exists
40003	A shop can have at most 300 categories
40004	This category is archived
40005	Unknown category
41001	is counted in , which allows at most decimal places
41002	is sold only in the shop and cannot be ordered here
41003	Enter a quantity as a number with at most 3 decimal places