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

CustomerGetCurrentAction CustomerAddressGetAllAction CustomerAddressCreateAction CustomerAddressUpdateAction CustomerAddressDeleteAction CustomerAddressSetDefaultAction WishlistAddItemsAction

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 WishlistAddItemsAction

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