Ecommerce

Errors

Canonical error types for ecommerce connector apps

Canonical errors are thrown by action handlers when an operation fails in a predictable way. Your connector app should throw these errors so the frontend can handle them consistently (e.g., show a form validation message or a stock warning).

Import these from @laioutr-core/canonical-types/ecommerce.

Auth

InvalidCredentialsError

AUTH_INVALID_CREDENTIALS401

Thrown when authentication with the provided credentials fails.

Thrown by

AuthLoginAction ProductReviewsCreateAction

UnauthenticatedError

AUTH_UNAUTHENTICATED401

Thrown when the user tries to access a resource that requires authentication.

Thrown by

OrganizationGetMembershipsAction OrganizationSwitchAction OrganizationSetLoginPreferencesAction OrganizationEmployeeInviteAction OrganizationEmployeeUpdateAction OrganizationEmployeeDeleteAction OrganizationRoleGetAllAction OrganizationRoleCreateAction OrganizationRoleUpdateAction OrganizationRoleDeleteAction OrganizationAddressGetAllAction OrganizationAddressCreateAction OrganizationAddressUpdateAction OrganizationAddressDeleteAction OrganizationAddressSetDefaultAction OrganizationCostCenterCreateAction OrganizationCostCenterUpdateAction OrganizationCostCenterDeleteAction OrganizationBudgetCreateAction OrganizationBudgetUpdateAction OrganizationBudgetDeleteAction OrganizationProductNumberGetAllAction OrganizationProductNumberSetAction OrganizationProductNumberDeleteAction QuoteRequestAction QuoteAcceptAction QuoteDeclineAction QuoteRequestChangeAction QuoteCancelAction QuoteGetCheckoutUrlAction ApprovalFlowDecideAction CartShareSetAction CartShareGetAllAction CartShareDeleteAction CustomerGetCurrentAction CustomerUpdateAction CustomerAddressGetAllAction CustomerAddressCreateAction CustomerAddressUpdateAction CustomerAddressDeleteAction CustomerAddressSetDefaultAction OrderReorderAction OrderCancelAction OrderGetStatisticsAction DocumentGetAllAction DocumentGetDownloadUrlAction ProductListCreateAction ProductListUpdateAction ProductListDeleteAction ProductListDuplicateAction ProductListAddItemsAction ProductListUpdateItemsAction ProductListRemoveItemsAction ProductListAddToCartAction

CustomerDisabledError

AUTH_CUSTOMER_DISABLED403

Thrown when a customer that is trying to login is disabled.

Cart

ProductNotFoundError

CART_PRODUCT_NOT_FOUND404

Thrown when a product that should be added to the cart is not found.

Error Data

variantIdstring

Thrown by

CartAddItemsAction ProductListAddItemsAction OrganizationProductNumberSetAction

ProductStockError

CART_PRODUCT_STOCK_ERROR

Thrown when a product cannot be added to the cart due to stock issues.

Error Data

variantIdstring

reasonProductStockErrorReason

Reason Values

OUT_OF_STOCKNOT_ENOUGH_STOCK

Thrown by

CartAddItemsAction

ProductQuantityError

CART_PRODUCT_QUANTITY_ERROR

Thrown when an item cannot be added to the cart due to quantity constraints.

Error Data

variantIdstring

reasonProductQuantityErrorReason

Reason Values

MINIMUM_NOT_METMAXIMUM_EXCEEDEDINVALID_INCREMENT

Thrown by

CartAddItemsAction

DiscountCodeNotFoundError

CART_DISCOUNT_CODE_NOT_FOUND404

Thrown when a discount code that should be added to the cart is not found.

Error Data

codestring

Thrown by

CartAddItemsAction

DiscountCodeNotRedeemableError

CART_DISCOUNT_CODE_NOT_REDEEMABLE

Thrown when a discount code cannot be applied to the cart.

Error Data

codestring

reasonDiscountCodeNotRedeemableErrorReason

Reason Values

CODE_NOT_HONOUREDCURRENTLY_INACTIVECUSTOMER_NOT_ELIGIBLECUSTOMER_USAGE_LIMIT_REACHEDELIGIBLE_CUSTOMER_MISSINGINCOMPATIBLE_PURCHASE_TYPENO_ENTITLED_LINE_ITEMSNO_ENTITLED_SHIPPING_LINESPURCHASE_NOT_IN_RANGEQUANTITY_NOT_IN_RANGEUSAGE_LIMIT_REACHEDOTHER

Thrown by

CartAddItemsAction