@zenglobal/api-client 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +134 -0
- package/dist/client/client/client.gen.d.ts +3 -0
- package/dist/client/client/client.gen.d.ts.map +1 -0
- package/dist/client/client/client.gen.js +257 -0
- package/dist/client/client/client.gen.js.map +1 -0
- package/dist/client/client/index.d.ts +9 -0
- package/dist/client/client/index.d.ts.map +1 -0
- package/dist/client/client/index.js +7 -0
- package/dist/client/client/index.js.map +1 -0
- package/dist/client/client/types.gen.d.ts +146 -0
- package/dist/client/client/types.gen.d.ts.map +1 -0
- package/dist/client/client/types.gen.js +3 -0
- package/dist/client/client/types.gen.js.map +1 -0
- package/dist/client/client/utils.gen.d.ts +34 -0
- package/dist/client/client/utils.gen.d.ts.map +1 -0
- package/dist/client/client/utils.gen.js +227 -0
- package/dist/client/client/utils.gen.js.map +1 -0
- package/dist/client/client.gen.d.ts +13 -0
- package/dist/client/client.gen.d.ts.map +1 -0
- package/dist/client/client.gen.js +4 -0
- package/dist/client/client.gen.js.map +1 -0
- package/dist/client/core/auth.gen.d.ts +19 -0
- package/dist/client/core/auth.gen.d.ts.map +1 -0
- package/dist/client/core/auth.gen.js +15 -0
- package/dist/client/core/auth.gen.js.map +1 -0
- package/dist/client/core/bodySerializer.gen.d.ts +26 -0
- package/dist/client/core/bodySerializer.gen.d.ts.map +1 -0
- package/dist/client/core/bodySerializer.gen.js +58 -0
- package/dist/client/core/bodySerializer.gen.js.map +1 -0
- package/dist/client/core/params.gen.d.ts +44 -0
- package/dist/client/core/params.gen.d.ts.map +1 -0
- package/dist/client/core/params.gen.js +101 -0
- package/dist/client/core/params.gen.js.map +1 -0
- package/dist/client/core/pathSerializer.gen.d.ts +34 -0
- package/dist/client/core/pathSerializer.gen.d.ts.map +1 -0
- package/dist/client/core/pathSerializer.gen.js +107 -0
- package/dist/client/core/pathSerializer.gen.js.map +1 -0
- package/dist/client/core/queryKeySerializer.gen.d.ts +19 -0
- package/dist/client/core/queryKeySerializer.gen.d.ts.map +1 -0
- package/dist/client/core/queryKeySerializer.gen.js +93 -0
- package/dist/client/core/queryKeySerializer.gen.js.map +1 -0
- package/dist/client/core/serverSentEvents.gen.d.ts +72 -0
- package/dist/client/core/serverSentEvents.gen.d.ts.map +1 -0
- package/dist/client/core/serverSentEvents.gen.js +134 -0
- package/dist/client/core/serverSentEvents.gen.js.map +1 -0
- package/dist/client/core/types.gen.d.ts +79 -0
- package/dist/client/core/types.gen.d.ts.map +1 -0
- package/dist/client/core/types.gen.js +3 -0
- package/dist/client/core/types.gen.js.map +1 -0
- package/dist/client/core/utils.gen.d.ts +20 -0
- package/dist/client/core/utils.gen.d.ts.map +1 -0
- package/dist/client/core/utils.gen.js +88 -0
- package/dist/client/core/utils.gen.js.map +1 -0
- package/dist/client/index.d.ts +3 -0
- package/dist/client/index.d.ts.map +1 -0
- package/dist/client/index.js +3 -0
- package/dist/client/index.js.map +1 -0
- package/dist/client/sdk.gen.d.ts +1544 -0
- package/dist/client/sdk.gen.d.ts.map +1 -0
- package/dist/client/sdk.gen.js +2111 -0
- package/dist/client/sdk.gen.js.map +1 -0
- package/dist/client/types.gen.d.ts +10180 -0
- package/dist/client/types.gen.d.ts.map +1 -0
- package/dist/client/types.gen.js +3 -0
- package/dist/client/types.gen.js.map +1 -0
- package/dist/configure.d.ts +30 -0
- package/dist/configure.d.ts.map +1 -0
- package/dist/configure.js +71 -0
- package/dist/configure.js.map +1 -0
- package/dist/errors.d.ts +23 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +25 -0
- package/dist/errors.js.map +1 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +10 -0
- package/dist/index.js.map +1 -0
- package/package.json +54 -0
|
@@ -0,0 +1,1544 @@
|
|
|
1
|
+
import type { Client, Options as Options2, TDataShape } from './client/index.js';
|
|
2
|
+
import type { EmailValidationValidateEmailData, EmailValidationValidateEmailErrors, EmailValidationValidateEmailResponses, EventsProcessEventData, EventsProcessEventErrors, EventsProcessEventResponses, GatewayGetGatewayConfigData, GatewayGetGatewayConfigErrors, GatewayGetGatewayConfigResponses, InventoryBulkInventoryData, InventoryBulkInventoryErrors, InventoryBulkInventoryResponses, InventoryGetDepartmentItemsData, InventoryGetDepartmentItemsErrors, InventoryGetDepartmentItemsResponses, InventoryGetItemData, InventoryGetItemErrors, InventoryGetItemResponses, InventorySearchInventoryData, InventorySearchInventoryErrors, InventorySearchInventoryResponses, JackpotsListData, JackpotsListErrors, JackpotsListResponses, JackpotsListWinnersData, JackpotsListWinnersErrors, JackpotsListWinnersResponses, ListsCreateListData, ListsCreateListErrors, ListsCreateListResponses, ListsCreateListWithCardData, ListsCreateListWithCardErrors, ListsCreateListWithCardResponses, ListsDeleteListData, ListsDeleteListErrors, ListsDeleteListResponses, ListsGetAllListsData, ListsGetAllListsErrors, ListsGetAllListsResponses, ListsGetCardListsData, ListsGetCardListsErrors, ListsGetCardListsResponses, ListsRemoveCardFromListData, ListsRemoveCardFromListErrors, ListsRemoveCardFromListResponses, ListsUpdateListData, ListsUpdateListErrors, ListsUpdateListResponses, ListsUpdateListWithCardData, ListsUpdateListWithCardErrors, ListsUpdateListWithCardResponses, LoyaltyActivateCardData, LoyaltyActivateCardErrors, LoyaltyActivateCardResponses, LoyaltyCreateCardData, LoyaltyCreateCardErrors, LoyaltyCreateCardResponses, LoyaltyCreatePointsTransactionData, LoyaltyCreatePointsTransactionErrors, LoyaltyCreatePointsTransactionResponses, LoyaltyDeactivateCardData, LoyaltyDeactivateCardErrors, LoyaltyDeactivateCardResponses, LoyaltyGenerateShortCodeData, LoyaltyGenerateShortCodeErrors, LoyaltyGenerateShortCodeResponses, LoyaltyGetAllowedFunctionsData, LoyaltyGetAllowedFunctionsErrors, LoyaltyGetAllowedFunctionsResponses, LoyaltyGetCardData, LoyaltyGetCardErrors, LoyaltyGetCardImageData, LoyaltyGetCardImageErrors, LoyaltyGetCardImageResponses, LoyaltyGetCardRecoveryData, LoyaltyGetCardRecoveryErrors, LoyaltyGetCardRecoveryResponses, LoyaltyGetCardResponses, LoyaltyGetCardTypesData, LoyaltyGetCardTypesErrors, LoyaltyGetCardTypesResponses, LoyaltyGetCardWithOffersData, LoyaltyGetCardWithOffersErrors, LoyaltyGetCardWithOffersResponses, LoyaltyGetCoffeeCardStatsData, LoyaltyGetCoffeeCardStatsErrors, LoyaltyGetCoffeeCardStatsResponses, LoyaltyGetCompulsoryFieldsData, LoyaltyGetCompulsoryFieldsErrors, LoyaltyGetCompulsoryFieldsResponses, LoyaltyGetGroupsData, LoyaltyGetGroupsErrors, LoyaltyGetGroupsResponses, LoyaltyGetMemberGroupsData, LoyaltyGetMemberGroupsErrors, LoyaltyGetMemberGroupsResponses, LoyaltyGetSettingsData, LoyaltyGetSettingsErrors, LoyaltyGetSettingsResponses, LoyaltyGetSyncListByCommandData, LoyaltyGetSyncListByCommandErrors, LoyaltyGetSyncListByCommandResponses, LoyaltyGetSyncListData, LoyaltyGetSyncListErrors, LoyaltyGetSyncListResponses, LoyaltyGetWalletLinkData, LoyaltyGetWalletLinkErrors, LoyaltyGetWalletLinkResponses, LoyaltyRenewCardData, LoyaltyRenewCardErrors, LoyaltyRenewCardResponses, LoyaltySearchCardsData, LoyaltySearchCardsErrors, LoyaltySearchCardsResponses, LoyaltyUpdateAddressData, LoyaltyUpdateAddressErrors, LoyaltyUpdateAddressResponses, LoyaltyUpdateBillingAddressData, LoyaltyUpdateBillingAddressErrors, LoyaltyUpdateBillingAddressResponses, LoyaltyUpdateCardData, LoyaltyUpdateCardErrors, LoyaltyUpdateCardPinData, LoyaltyUpdateCardPinErrors, LoyaltyUpdateCardPinResponses, LoyaltyUpdateCardResponses, LoyaltyUpdateCardTokenData, LoyaltyUpdateCardTokenErrors, LoyaltyUpdateCardTokenResponses, LoyaltyUpdateExternalUserIdData, LoyaltyUpdateExternalUserIdErrors, LoyaltyUpdateExternalUserIdResponses, LoyaltyUpdateGroupsData, LoyaltyUpdateGroupsErrors, LoyaltyUpdateGroupsResponses, LoyaltyUpdateMemberGroupsData, LoyaltyUpdateMemberGroupsErrors, LoyaltyUpdateMemberGroupsResponses, LoyaltyUpdatePointsData, LoyaltyUpdatePointsErrors, LoyaltyUpdatePointsResponses, LoyaltyUpdateShippingAddressData, LoyaltyUpdateShippingAddressErrors, LoyaltyUpdateShippingAddressResponses, LoyaltyUpdateSyncListData, LoyaltyUpdateSyncListErrors, LoyaltyUpdateSyncListResponses, LoyaltyVerifyCardData, LoyaltyVerifyCardErrors, LoyaltyVerifyCardResponses, MembershipActivateMemberData, MembershipActivateMemberErrors, MembershipActivateMemberResponses, MembershipCancelMemberData, MembershipCancelMemberErrors, MembershipCancelMemberResponses, MembershipCreateMemberData, MembershipCreateMemberErrors, MembershipCreateMemberResponses, MembershipGetAllowedFunctionsData, MembershipGetAllowedFunctionsErrors, MembershipGetAllowedFunctionsResponses, MembershipGetMemberByCardData, MembershipGetMemberByCardErrors, MembershipGetMemberByCardResponses, MembershipGetMemberData, MembershipGetMemberErrors, MembershipGetMemberGroupsAltData, MembershipGetMemberGroupsAltErrors, MembershipGetMemberGroupsAltResponses, MembershipGetMemberGroupsData, MembershipGetMemberGroupsErrors, MembershipGetMemberGroupsResponses, MembershipGetMemberResponses, MembershipReplaceCreditCardData, MembershipReplaceCreditCardErrors, MembershipReplaceCreditCardResponses, MembershipSearchMembersData, MembershipSearchMembersErrors, MembershipSearchMembersResponses, MembershipSuspendMemberData, MembershipSuspendMemberErrors, MembershipSuspendMemberResponses, MembershipUpdateBillingAddressData, MembershipUpdateBillingAddressErrors, MembershipUpdateBillingAddressResponses, MembershipUpdateMemberAddressData, MembershipUpdateMemberAddressErrors, MembershipUpdateMemberAddressResponses, MembershipUpdateMemberByCardData, MembershipUpdateMemberByCardErrors, MembershipUpdateMemberByCardResponses, MembershipUpdateMemberData, MembershipUpdateMemberErrors, MembershipUpdateMemberResponses, MembershipUpdateMemberTokenData, MembershipUpdateMemberTokenErrors, MembershipUpdateMemberTokenResponses, MembershipUpdateShippingAddressData, MembershipUpdateShippingAddressErrors, MembershipUpdateShippingAddressResponses, OfferCreateData, OfferCreateErrors, OfferCreateResponses, OfferDeleteData, OfferDeleteErrors, OfferDeleteResponses, OfferGetCoffeeCardStatsData, OfferGetCoffeeCardStatsErrors, OfferGetCoffeeCardStatsResponses, OfferListData, OfferListErrors, OfferListResponses, OfferRedemptionsListData, OfferRedemptionsListErrors, OfferRedemptionsListResponses, OfferUpdateData, OfferUpdateErrors, OfferUpdateResponses, OrderCreateOrderData, OrderCreateOrderErrors, OrderCreateOrderResponses, OrderDeleteOrderData, OrderDeleteOrderErrors, OrderDeleteOrderResponses, OrderGetAllowedFunctionsData, OrderGetAllowedFunctionsErrors, OrderGetAllowedFunctionsResponses, OrderGetOrderData, OrderGetOrderErrors, OrderGetOrderResponses, OrderSearchOrdersData, OrderSearchOrdersErrors, OrderSearchOrdersResponses, PingPingData, PingPingErrors, PingPingResponses, SitesGetSitesData, SitesGetSitesErrors, SitesGetSitesResponses, SmsGetSentSmsListData, SmsGetSentSmsListErrors, SmsGetSentSmsListResponses, SmsGetSmsBalanceData, SmsGetSmsBalanceErrors, SmsGetSmsBalanceResponses, SmsGetSmsRepliesData, SmsGetSmsRepliesErrors, SmsGetSmsRepliesResponses, SmsGetSmsResponsesData, SmsGetSmsResponsesErrors, SmsGetSmsResponsesResponses, SmsSendSmsData, SmsSendSmsErrors, SmsSendSmsResponses, StripeGetStripeConfigData, StripeGetStripeConfigErrors, StripeGetStripeConfigResponses, TransactionCreateTransactionData, TransactionCreateTransactionErrors, TransactionCreateTransactionResponses, TransactionGetTransactionData, TransactionGetTransactionErrors, TransactionGetTransactionResponses, VersionGetVersionData, VersionGetVersionErrors, VersionGetVersionResponses, VoucherCreateVoucherData, VoucherCreateVoucherErrors, VoucherCreateVoucherResponses, VoucherDeleteVoucherData, VoucherDeleteVoucherErrors, VoucherDeleteVoucherResponses, VoucherEnquireVoucherData, VoucherEnquireVoucherErrors, VoucherEnquireVoucherResponses, VoucherGetVoucherImageData, VoucherGetVoucherImageErrors, VoucherGetVoucherImageResponses, VoucherGetVoucherTypeData, VoucherGetVoucherTypeErrors, VoucherGetVoucherTypeResponses, VoucherRechargeVoucherData, VoucherRechargeVoucherErrors, VoucherRechargeVoucherResponses, VoucherRedeemVoucherData, VoucherRedeemVoucherErrors, VoucherRedeemVoucherResponses, VoucherReleaseVoucherData, VoucherReleaseVoucherErrors, VoucherReleaseVoucherResponses, VoucherReserveVoucherData, VoucherReserveVoucherErrors, VoucherReserveVoucherResponses, VoucherSearchVouchersData, VoucherSearchVouchersErrors, VoucherSearchVouchersFlatData, VoucherSearchVouchersFlatErrors, VoucherSearchVouchersFlatResponses, VoucherSearchVouchersResponses } from './types.gen.js';
|
|
3
|
+
export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = Options2<TData, ThrowOnError> & {
|
|
4
|
+
/**
|
|
5
|
+
* You can provide a client instance returned by `createClient()` instead of
|
|
6
|
+
* individual options. This might be also useful if you want to implement a
|
|
7
|
+
* custom client.
|
|
8
|
+
*/
|
|
9
|
+
client?: Client;
|
|
10
|
+
/**
|
|
11
|
+
* You can pass arbitrary values through the `meta` object. This can be
|
|
12
|
+
* used to access values that aren't defined as part of the SDK function.
|
|
13
|
+
*/
|
|
14
|
+
meta?: Record<string, unknown>;
|
|
15
|
+
};
|
|
16
|
+
/**
|
|
17
|
+
* Send SMS
|
|
18
|
+
*
|
|
19
|
+
* Send an SMS message.
|
|
20
|
+
*
|
|
21
|
+
* The request body must be wrapped in an `sms` key: `{"sms": {...}}`.
|
|
22
|
+
*
|
|
23
|
+
* **Required scope:** `SEND_SMS`
|
|
24
|
+
*
|
|
25
|
+
* **Error codes:**
|
|
26
|
+
* - `8` (Missing Data) - Body Missing
|
|
27
|
+
* - `45` (Invalid JSON) - Invalid JSON body
|
|
28
|
+
* - `51` (SMS Not Enabled) - SMS sending not enabled for this chain
|
|
29
|
+
* - `32` (Balance Zero) - No SMS units remaining
|
|
30
|
+
* - `33` (Length Exceeded) - Message exceeds maximum length
|
|
31
|
+
* - `7` (Invalid Mobile) - Mobile number invalid or wrong length
|
|
32
|
+
* - `23` (Missing Mobile) - Mobile number not provided
|
|
33
|
+
* - `50` (SMS Error) - SMS sending failed
|
|
34
|
+
*/
|
|
35
|
+
export declare const smsSendSms: <ThrowOnError extends boolean = false>(options: Options<SmsSendSmsData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<SmsSendSmsResponses, SmsSendSmsErrors, ThrowOnError, "fields">;
|
|
36
|
+
/**
|
|
37
|
+
* Get SMS Balance
|
|
38
|
+
*
|
|
39
|
+
* Get SMS balance and usage information for a site.
|
|
40
|
+
*
|
|
41
|
+
* Returns the remaining SMS balance, unit cost, and total units sent.
|
|
42
|
+
*
|
|
43
|
+
* **Required scope:** `READ_SMS`
|
|
44
|
+
*
|
|
45
|
+
* **Error codes:**
|
|
46
|
+
* - `8` (Missing Data) - Invalid Site
|
|
47
|
+
*/
|
|
48
|
+
export declare const smsGetSmsBalance: <ThrowOnError extends boolean = false>(options: Options<SmsGetSmsBalanceData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<SmsGetSmsBalanceResponses, SmsGetSmsBalanceErrors, ThrowOnError, "fields">;
|
|
49
|
+
/**
|
|
50
|
+
* Get SMS Replies
|
|
51
|
+
*
|
|
52
|
+
* Get SMS replies for a site.
|
|
53
|
+
*
|
|
54
|
+
* **Note:** This endpoint is currently a stub and always returns an empty JSON object.
|
|
55
|
+
*
|
|
56
|
+
* **Required scope:** `READ_SMS`
|
|
57
|
+
*
|
|
58
|
+
* **Error codes:**
|
|
59
|
+
* - `4` (Not Found) - missing search string, missing from date
|
|
60
|
+
* - `8` (Missing Data) - Invalid Site
|
|
61
|
+
*/
|
|
62
|
+
export declare const smsGetSmsReplies: <ThrowOnError extends boolean = false>(options: Options<SmsGetSmsRepliesData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<SmsGetSmsRepliesResponses, SmsGetSmsRepliesErrors, ThrowOnError, "fields">;
|
|
63
|
+
/**
|
|
64
|
+
* Get SMS Responses
|
|
65
|
+
*
|
|
66
|
+
* Get SMS response list for a site.
|
|
67
|
+
*
|
|
68
|
+
* **Note:** This endpoint is currently a stub and always returns an empty JSON object.
|
|
69
|
+
* Both URL paths `/SMS/response/{site}` and `/SMS/reponse/{site}` (legacy typo) are accepted.
|
|
70
|
+
*
|
|
71
|
+
* **Required scope:** `READ_SMS`
|
|
72
|
+
*
|
|
73
|
+
* **Error codes:**
|
|
74
|
+
* - `4` (Not Found) - missing search string, missing from date, missing to date, missing mobile
|
|
75
|
+
* - `8` (Missing Data) - Invalid Site
|
|
76
|
+
*/
|
|
77
|
+
export declare const smsGetSmsResponses: <ThrowOnError extends boolean = false>(options: Options<SmsGetSmsResponsesData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<SmsGetSmsResponsesResponses, SmsGetSmsResponsesErrors, ThrowOnError, "fields">;
|
|
78
|
+
/**
|
|
79
|
+
* Get Sent SMS List
|
|
80
|
+
*
|
|
81
|
+
* Get list of SMS messages sent to a mobile number within a date range.
|
|
82
|
+
*
|
|
83
|
+
* Both `from` and `to` query parameters are required. The mobile number
|
|
84
|
+
* is passed as a path parameter. Numbers starting with '04' are automatically
|
|
85
|
+
* converted to international format (614...).
|
|
86
|
+
*
|
|
87
|
+
* **Required scope:** `READ_SMS`
|
|
88
|
+
*
|
|
89
|
+
* **Error codes:**
|
|
90
|
+
* - `4` (Not Found) - missing search string, missing from date, missing to date, missing mobile
|
|
91
|
+
*/
|
|
92
|
+
export declare const smsGetSentSmsList: <ThrowOnError extends boolean = false>(options: Options<SmsGetSentSmsListData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<SmsGetSentSmsListResponses, SmsGetSentSmsListErrors, ThrowOnError, "fields">;
|
|
93
|
+
/**
|
|
94
|
+
* Process Event
|
|
95
|
+
*
|
|
96
|
+
* Receives and processes event webhooks. The request body must be valid JSON
|
|
97
|
+
* containing the required `name`, `id`, and `payload` fields.
|
|
98
|
+
*
|
|
99
|
+
* Currently supported event names:
|
|
100
|
+
* * `order/delivered` - Order delivery confirmation
|
|
101
|
+
* * `order/rejected` - Order rejection notification
|
|
102
|
+
*
|
|
103
|
+
* **Required scope:** `write:events`
|
|
104
|
+
*
|
|
105
|
+
* **Error codes:**
|
|
106
|
+
* * `1` (Invalid Access Key) - Missing or invalid API key, or missing `write:events` scope
|
|
107
|
+
* * `9` (Request Rejected) - Request payload does not contain required fields, unknown event type, or company is disabled
|
|
108
|
+
*/
|
|
109
|
+
export declare const eventsProcessEvent: <ThrowOnError extends boolean = false>(options: Options<EventsProcessEventData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<EventsProcessEventResponses, EventsProcessEventErrors, ThrowOnError, "fields">;
|
|
110
|
+
/**
|
|
111
|
+
* Get Gateway Configuration
|
|
112
|
+
*
|
|
113
|
+
* Get payment gateway configurations for all providers.
|
|
114
|
+
*
|
|
115
|
+
* Returns configuration for Stripe, eWay, and PayPal gateways
|
|
116
|
+
* including API keys, currency settings, and sandbox status.
|
|
117
|
+
*
|
|
118
|
+
* Required scope: `read:gateway`
|
|
119
|
+
*/
|
|
120
|
+
export declare const gatewayGetGatewayConfig: <ThrowOnError extends boolean = false>(options?: Options<GatewayGetGatewayConfigData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<GatewayGetGatewayConfigResponses, GatewayGetGatewayConfigErrors, ThrowOnError, "fields">;
|
|
121
|
+
/**
|
|
122
|
+
* Get Department Items
|
|
123
|
+
*
|
|
124
|
+
* Get all items in a specific department.
|
|
125
|
+
*
|
|
126
|
+
* Returns inventory items grouped by department. The response is returned
|
|
127
|
+
* directly via `prepareJson()` without `result`/`errormessage` wrapper fields.
|
|
128
|
+
*
|
|
129
|
+
* **Required scope:** `read:inventory`
|
|
130
|
+
*
|
|
131
|
+
* **Error codes:**
|
|
132
|
+
* - `4` (Not Found) - No items found in the department
|
|
133
|
+
* - `8` (Missing Data) - Invalid site
|
|
134
|
+
*/
|
|
135
|
+
export declare const inventoryGetDepartmentItems: <ThrowOnError extends boolean = false>(options: Options<InventoryGetDepartmentItemsData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<InventoryGetDepartmentItemsResponses, InventoryGetDepartmentItemsErrors, ThrowOnError, "fields">;
|
|
136
|
+
/**
|
|
137
|
+
* Get Item Details
|
|
138
|
+
*
|
|
139
|
+
* Get specific item details by item number.
|
|
140
|
+
*
|
|
141
|
+
* Performs an exact item number lookup and returns results grouped by department,
|
|
142
|
+
* using the same response structure as the search endpoint. The response is returned
|
|
143
|
+
* directly via `prepareJson()` without `result`/`errormessage` wrapper fields.
|
|
144
|
+
*
|
|
145
|
+
* **Required scope:** `read:inventory`
|
|
146
|
+
*
|
|
147
|
+
* **Error codes:**
|
|
148
|
+
* - `4` (Not Found) - Item not found
|
|
149
|
+
* - `8` (Missing Data) - Invalid site
|
|
150
|
+
*/
|
|
151
|
+
export declare const inventoryGetItem: <ThrowOnError extends boolean = false>(options: Options<InventoryGetItemData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<InventoryGetItemResponses, InventoryGetItemErrors, ThrowOnError, "fields">;
|
|
152
|
+
/**
|
|
153
|
+
* Search Inventory
|
|
154
|
+
*
|
|
155
|
+
* Search inventory items by various criteria.
|
|
156
|
+
*
|
|
157
|
+
* The search value is taken from the raw query string (everything after the `?`),
|
|
158
|
+
* not from a named query parameter. For example:
|
|
159
|
+
* `GET /inventory/{siteCode}/search/description?Bombay Gin`
|
|
160
|
+
*
|
|
161
|
+
* The response groups results by department. The response is returned
|
|
162
|
+
* directly via `prepareJson()` without `result`/`errormessage` wrapper fields.
|
|
163
|
+
*
|
|
164
|
+
* **Required scope:** `read:inventory`
|
|
165
|
+
*
|
|
166
|
+
* **Available search commands:**
|
|
167
|
+
* - `number` - Search by item number (partial match)
|
|
168
|
+
* - `description` - Search by item description (case-insensitive partial match)
|
|
169
|
+
* - `supplier` - Search by product owner/supplier (partial match)
|
|
170
|
+
* - `colour` - Search by colour attribute (partial match)
|
|
171
|
+
* - `style` - Search by style attribute (partial match)
|
|
172
|
+
* - `size` - Search by size attribute (partial match)
|
|
173
|
+
* - `barcode` - Search by barcode (partial match)
|
|
174
|
+
*
|
|
175
|
+
* **Error codes:**
|
|
176
|
+
* - `4` (Not Found) - No items match the search
|
|
177
|
+
* - `8` (Missing Data) - Invalid site
|
|
178
|
+
* - `9` (Request Rejected) - Unknown search command
|
|
179
|
+
*/
|
|
180
|
+
export declare const inventorySearchInventory: <ThrowOnError extends boolean = false>(options: Options<InventorySearchInventoryData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<InventorySearchInventoryResponses, InventorySearchInventoryErrors, ThrowOnError, "fields">;
|
|
181
|
+
/**
|
|
182
|
+
* Bulk update Inventory
|
|
183
|
+
*
|
|
184
|
+
* This endpoint is designed to bulk process a series of inventory changes for a given location.
|
|
185
|
+
*
|
|
186
|
+
* > info
|
|
187
|
+
* > All process will happen asynchronously and updates are processed in the order they arrive.
|
|
188
|
+
*
|
|
189
|
+
* **Required scope:** `write:inventory`
|
|
190
|
+
*
|
|
191
|
+
* Supports `Content-Encoding: gzip` for compressed request bodies.
|
|
192
|
+
*
|
|
193
|
+
* **Error codes:**
|
|
194
|
+
* - `0` (OK) - Bulk update submitted successfully
|
|
195
|
+
* - `8` (Missing Data) - Request body is empty
|
|
196
|
+
* - `9` (Request Rejected) - Failed to parse JSON or validation errors
|
|
197
|
+
*/
|
|
198
|
+
export declare const inventoryBulkInventory: <ThrowOnError extends boolean = false>(options: Options<InventoryBulkInventoryData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<InventoryBulkInventoryResponses, InventoryBulkInventoryErrors, ThrowOnError, "fields">;
|
|
199
|
+
/**
|
|
200
|
+
* List Jackpots
|
|
201
|
+
*
|
|
202
|
+
* Returns active jackpots with optional date range filtering and pagination.
|
|
203
|
+
*
|
|
204
|
+
* **Required scope:** `read:jackpots`
|
|
205
|
+
*
|
|
206
|
+
* **Error codes:**
|
|
207
|
+
* * `1` (Invalid Access Key) - Missing or invalid API key, or missing `read:jackpots` scope
|
|
208
|
+
* * `3` (Invalid Function) - Request method is not GET
|
|
209
|
+
* * `9` (Request Rejected) - Company is disabled
|
|
210
|
+
*/
|
|
211
|
+
export declare const jackpotsList: <ThrowOnError extends boolean = false>(options?: Options<JackpotsListData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<JackpotsListResponses, JackpotsListErrors, ThrowOnError, "fields">;
|
|
212
|
+
/**
|
|
213
|
+
* List Jackpot Winners
|
|
214
|
+
*
|
|
215
|
+
* Returns jackpot winners with optional date range and site filtering, with pagination.
|
|
216
|
+
*
|
|
217
|
+
* **Required scope:** `read:jackpots`
|
|
218
|
+
*
|
|
219
|
+
* **Error codes:**
|
|
220
|
+
* * `1` (Invalid Access Key) - Missing or invalid API key, or missing `read:jackpots` scope
|
|
221
|
+
* * `3` (Invalid Function) - Request method is not GET
|
|
222
|
+
* * `9` (Request Rejected) - Company is disabled
|
|
223
|
+
*/
|
|
224
|
+
export declare const jackpotsListWinners: <ThrowOnError extends boolean = false>(options?: Options<JackpotsListWinnersData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<JackpotsListWinnersResponses, JackpotsListWinnersErrors, ThrowOnError, "fields">;
|
|
225
|
+
/**
|
|
226
|
+
* Delete List
|
|
227
|
+
*
|
|
228
|
+
* Delete an entire list definition.
|
|
229
|
+
*
|
|
230
|
+
* Deletes the list definition entirely. Requires the `allowdelete` flag to be set to true
|
|
231
|
+
* in the request body. The list must exist.
|
|
232
|
+
*
|
|
233
|
+
* **Required scope:** `delete:lists`
|
|
234
|
+
*
|
|
235
|
+
* **Error codes:**
|
|
236
|
+
* * `1` (Invalid Access Key) - Missing or invalid API key, or missing `delete:lists` scope
|
|
237
|
+
* * `8` (Missing Data) - Request body is empty
|
|
238
|
+
* * `9` (Request Rejected) - List does not exist, id not defined, id references a non-list profile, or allowdelete flag is missing
|
|
239
|
+
* * `11` (Database Error) - Failed to delete the list
|
|
240
|
+
* * `45` (Invalid JSON) - Request body is not valid JSON
|
|
241
|
+
*/
|
|
242
|
+
export declare const listsDeleteList: <ThrowOnError extends boolean = false>(options: Options<ListsDeleteListData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<ListsDeleteListResponses, ListsDeleteListErrors, ThrowOnError, "fields">;
|
|
243
|
+
/**
|
|
244
|
+
* Get All Lists
|
|
245
|
+
*
|
|
246
|
+
* Get all list definitions for the chain.
|
|
247
|
+
*
|
|
248
|
+
* Returns all communication profile list definitions (PROFILEHEADER rows where ISLIST='T').
|
|
249
|
+
* Each list includes its id, description, enabled status, comments, and card count.
|
|
250
|
+
* The response `lists` object contains list definitions keyed by id, plus a `card` field
|
|
251
|
+
* set to an empty string.
|
|
252
|
+
*
|
|
253
|
+
* **Required scope:** `read:lists`
|
|
254
|
+
*
|
|
255
|
+
* **Error codes:**
|
|
256
|
+
* * `1` (Invalid Access Key) - Missing or invalid API key, or missing `read:lists` scope
|
|
257
|
+
*/
|
|
258
|
+
export declare const listsGetAllLists: <ThrowOnError extends boolean = false>(options?: Options<ListsGetAllListsData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<ListsGetAllListsResponses, ListsGetAllListsErrors, ThrowOnError, "fields">;
|
|
259
|
+
/**
|
|
260
|
+
* Create List
|
|
261
|
+
*
|
|
262
|
+
* Create a new list definition.
|
|
263
|
+
*
|
|
264
|
+
* Creates a new communication profile list. The request body must be wrapped
|
|
265
|
+
* in a `lists` key. If an `id` is provided and a list with that id already exists,
|
|
266
|
+
* returns a request rejected error.
|
|
267
|
+
*
|
|
268
|
+
* **Required scope:** `write:lists`
|
|
269
|
+
*
|
|
270
|
+
* **Error codes:**
|
|
271
|
+
* * `1` (Invalid Access Key) - Missing or invalid API key, or missing `write:lists` scope
|
|
272
|
+
* * `8` (Missing Data) - Request body is empty
|
|
273
|
+
* * `9` (Request Rejected) - List id already exists, or id references a non-list profile
|
|
274
|
+
* * `11` (Database Error) - Failed to create the list
|
|
275
|
+
* * `45` (Invalid JSON) - Request body is not valid JSON
|
|
276
|
+
*/
|
|
277
|
+
export declare const listsCreateList: <ThrowOnError extends boolean = false>(options: Options<ListsCreateListData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<ListsCreateListResponses, ListsCreateListErrors, ThrowOnError, "fields">;
|
|
278
|
+
/**
|
|
279
|
+
* Update List
|
|
280
|
+
*
|
|
281
|
+
* Update an existing list definition.
|
|
282
|
+
*
|
|
283
|
+
* Updates the description, comments, and enabled status of an existing list.
|
|
284
|
+
* The list must already exist. The request body must be wrapped in a `lists` key.
|
|
285
|
+
*
|
|
286
|
+
* **Required scope:** `write:lists`
|
|
287
|
+
*
|
|
288
|
+
* **Error codes:**
|
|
289
|
+
* * `1` (Invalid Access Key) - Missing or invalid API key, or missing `write:lists` scope
|
|
290
|
+
* * `8` (Missing Data) - Request body is empty
|
|
291
|
+
* * `9` (Request Rejected) - List does not exist, id not defined, or id references a non-list profile
|
|
292
|
+
* * `11` (Database Error) - Failed to update the list
|
|
293
|
+
* * `45` (Invalid JSON) - Request body is not valid JSON
|
|
294
|
+
*/
|
|
295
|
+
export declare const listsUpdateList: <ThrowOnError extends boolean = false>(options: Options<ListsUpdateListData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<ListsUpdateListResponses, ListsUpdateListErrors, ThrowOnError, "fields">;
|
|
296
|
+
/**
|
|
297
|
+
* Remove Card from List
|
|
298
|
+
*
|
|
299
|
+
* Remove a card from a list.
|
|
300
|
+
*
|
|
301
|
+
* Removes the specified card's membership from the list. The list must exist
|
|
302
|
+
* and the card must exist. Does not delete the list definition itself.
|
|
303
|
+
*
|
|
304
|
+
* **Required scope:** `delete:lists`
|
|
305
|
+
*
|
|
306
|
+
* **Error codes:**
|
|
307
|
+
* * `1` (Invalid Access Key) - Missing or invalid API key, or missing `delete:lists` scope
|
|
308
|
+
* * `4` (Not Found) - Card does not exist
|
|
309
|
+
* * `8` (Missing Data) - Request body is empty
|
|
310
|
+
* * `9` (Request Rejected) - List does not exist, id not defined, or id references a non-list profile
|
|
311
|
+
* * `11` (Database Error) - Failed to remove the card from the list
|
|
312
|
+
* * `45` (Invalid JSON) - Request body is not valid JSON
|
|
313
|
+
*/
|
|
314
|
+
export declare const listsRemoveCardFromList: <ThrowOnError extends boolean = false>(options: Options<ListsRemoveCardFromListData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<ListsRemoveCardFromListResponses, ListsRemoveCardFromListErrors, ThrowOnError, "fields">;
|
|
315
|
+
/**
|
|
316
|
+
* Get Lists for Card
|
|
317
|
+
*
|
|
318
|
+
* Get list definitions that a specific card belongs to.
|
|
319
|
+
*
|
|
320
|
+
* Returns only the list definitions that the specified card is a member of.
|
|
321
|
+
* If the card does not exist, returns a not found error.
|
|
322
|
+
* The response `lists` object contains list definitions keyed by id, plus a `card` field
|
|
323
|
+
* with the queried card number.
|
|
324
|
+
*
|
|
325
|
+
* **Required scope:** `read:lists`
|
|
326
|
+
*
|
|
327
|
+
* **Error codes:**
|
|
328
|
+
* * `1` (Invalid Access Key) - Missing or invalid API key, or missing `read:lists` scope
|
|
329
|
+
* * `4` (Not Found) - Card does not exist
|
|
330
|
+
*/
|
|
331
|
+
export declare const listsGetCardLists: <ThrowOnError extends boolean = false>(options: Options<ListsGetCardListsData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<ListsGetCardListsResponses, ListsGetCardListsErrors, ThrowOnError, "fields">;
|
|
332
|
+
/**
|
|
333
|
+
* Create List and Add Card
|
|
334
|
+
*
|
|
335
|
+
* Create a list definition and add a card to it.
|
|
336
|
+
*
|
|
337
|
+
* Creates or references a list and adds the specified card to it.
|
|
338
|
+
* If `id` is set and references an existing list, the card is added to that list.
|
|
339
|
+
* If the card does not exist, returns a not found error.
|
|
340
|
+
*
|
|
341
|
+
* **Required scope:** `write:lists`
|
|
342
|
+
*
|
|
343
|
+
* **Error codes:**
|
|
344
|
+
* * `1` (Invalid Access Key) - Missing or invalid API key, or missing `write:lists` scope
|
|
345
|
+
* * `4` (Not Found) - Card does not exist
|
|
346
|
+
* * `8` (Missing Data) - Request body is empty
|
|
347
|
+
* * `9` (Request Rejected) - Id references a non-list profile
|
|
348
|
+
* * `11` (Database Error) - Failed to create the list or add card
|
|
349
|
+
* * `45` (Invalid JSON) - Request body is not valid JSON
|
|
350
|
+
*/
|
|
351
|
+
export declare const listsCreateListWithCard: <ThrowOnError extends boolean = false>(options: Options<ListsCreateListWithCardData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<ListsCreateListWithCardResponses, ListsCreateListWithCardErrors, ThrowOnError, "fields">;
|
|
352
|
+
/**
|
|
353
|
+
* Update List with Card
|
|
354
|
+
*
|
|
355
|
+
* Update a list definition and update a card's association.
|
|
356
|
+
*
|
|
357
|
+
* Updates the list definition and associates the card with the list.
|
|
358
|
+
* If the card does not exist, returns a not found error.
|
|
359
|
+
*
|
|
360
|
+
* **Required scope:** `write:lists`
|
|
361
|
+
*
|
|
362
|
+
* **Error codes:**
|
|
363
|
+
* * `1` (Invalid Access Key) - Missing or invalid API key, or missing `write:lists` scope
|
|
364
|
+
* * `4` (Not Found) - Card does not exist
|
|
365
|
+
* * `8` (Missing Data) - Request body is empty
|
|
366
|
+
* * `9` (Request Rejected) - List does not exist, id not defined, or id references a non-list profile
|
|
367
|
+
* * `11` (Database Error) - Failed to update the list or card association
|
|
368
|
+
* * `45` (Invalid JSON) - Request body is not valid JSON
|
|
369
|
+
*/
|
|
370
|
+
export declare const listsUpdateListWithCard: <ThrowOnError extends boolean = false>(options: Options<ListsUpdateListWithCardData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<ListsUpdateListWithCardResponses, ListsUpdateListWithCardErrors, ThrowOnError, "fields">;
|
|
371
|
+
/**
|
|
372
|
+
* Get Allowed Functions
|
|
373
|
+
*
|
|
374
|
+
* Get list of allowed loyalty functions for the current API key.
|
|
375
|
+
* Returns an object keyed by feature name, each mapping to an array of allowed HTTP methods.
|
|
376
|
+
*
|
|
377
|
+
* **Required scope:** `READ_LOYALTY`
|
|
378
|
+
*/
|
|
379
|
+
export declare const loyaltyGetAllowedFunctions: <ThrowOnError extends boolean = false>(options?: Options<LoyaltyGetAllowedFunctionsData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyGetAllowedFunctionsResponses, LoyaltyGetAllowedFunctionsErrors, ThrowOnError, "fields">;
|
|
380
|
+
/**
|
|
381
|
+
* Create Card
|
|
382
|
+
*
|
|
383
|
+
* Create a new loyalty card. If no card number is provided, one is auto-generated.
|
|
384
|
+
* At minimum, an email or mobile number must be provided (unless `ispos` is true).
|
|
385
|
+
* Additional fields may be required based on the company's compulsory field settings
|
|
386
|
+
* (retrievable via GET /v1/loyalty/compulsory).
|
|
387
|
+
*/
|
|
388
|
+
export declare const loyaltyCreateCard: <ThrowOnError extends boolean = false>(options: Options<LoyaltyCreateCardData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyCreateCardResponses, LoyaltyCreateCardErrors, ThrowOnError, "fields">;
|
|
389
|
+
/**
|
|
390
|
+
* Get Card Details
|
|
391
|
+
*
|
|
392
|
+
* Get comprehensive loyalty card information.
|
|
393
|
+
* Supports short codes (6-character alphanumeric codes) in place of card numbers.
|
|
394
|
+
* Response is returned as raw JSON without result/errormessage wrapper.
|
|
395
|
+
*
|
|
396
|
+
* Use `includeoffers` sub-path with a site code to include available offers and
|
|
397
|
+
* recently redeemed offers in the response.
|
|
398
|
+
*
|
|
399
|
+
* Use `format=compact` query parameter to return only essential fields.
|
|
400
|
+
*
|
|
401
|
+
* **Required scope:** `READ_LOYALTY`
|
|
402
|
+
*
|
|
403
|
+
* **Error codes:**
|
|
404
|
+
* - `4` (Not Found) - Card not found or invalid card length
|
|
405
|
+
*/
|
|
406
|
+
export declare const loyaltyGetCard: <ThrowOnError extends boolean = false>(options: Options<LoyaltyGetCardData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyGetCardResponses, LoyaltyGetCardErrors, ThrowOnError, "fields">;
|
|
407
|
+
/**
|
|
408
|
+
* Update Card
|
|
409
|
+
*
|
|
410
|
+
* Update an existing loyalty card's details. The card number is provided in the URL path.
|
|
411
|
+
* Fields may be required based on the company's compulsory field settings
|
|
412
|
+
* (retrievable via GET /v1/loyalty/compulsory).
|
|
413
|
+
* Checks for duplicate email and mobile against other cards.
|
|
414
|
+
*
|
|
415
|
+
* **Required scope:** `WRITE_LOYALTY`
|
|
416
|
+
*/
|
|
417
|
+
export declare const loyaltyUpdateCard: <ThrowOnError extends boolean = false>(options: Options<LoyaltyUpdateCardData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyUpdateCardResponses, LoyaltyUpdateCardErrors, ThrowOnError, "fields">;
|
|
418
|
+
/**
|
|
419
|
+
* Activate Card
|
|
420
|
+
*
|
|
421
|
+
* Activate a loyalty card. Sets PURGED to false and CARDACTIVE to true.
|
|
422
|
+
* No request body required.
|
|
423
|
+
*
|
|
424
|
+
* **Required scope:** `WRITE_LOYALTY`
|
|
425
|
+
*/
|
|
426
|
+
export declare const loyaltyActivateCard: <ThrowOnError extends boolean = false>(options: Options<LoyaltyActivateCardData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyActivateCardResponses, LoyaltyActivateCardErrors, ThrowOnError, "fields">;
|
|
427
|
+
/**
|
|
428
|
+
* Update Address
|
|
429
|
+
*
|
|
430
|
+
* Update billing and/or shipping address for a loyalty card in a single call.
|
|
431
|
+
* At least one of billing, shipping, or deliveryinstruction must be provided.
|
|
432
|
+
*
|
|
433
|
+
* **Required scope:** `WRITE_LOYALTY`
|
|
434
|
+
*/
|
|
435
|
+
export declare const loyaltyUpdateAddress: <ThrowOnError extends boolean = false>(options: Options<LoyaltyUpdateAddressData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyUpdateAddressResponses, LoyaltyUpdateAddressErrors, ThrowOnError, "fields">;
|
|
436
|
+
/**
|
|
437
|
+
* Update Billing Address
|
|
438
|
+
*
|
|
439
|
+
* Update billing address for a loyalty card. Also updates the postcode on the loyalty record.
|
|
440
|
+
*
|
|
441
|
+
* **Required scope:** `WRITE_LOYALTY`
|
|
442
|
+
*/
|
|
443
|
+
export declare const loyaltyUpdateBillingAddress: <ThrowOnError extends boolean = false>(options: Options<LoyaltyUpdateBillingAddressData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyUpdateBillingAddressResponses, LoyaltyUpdateBillingAddressErrors, ThrowOnError, "fields">;
|
|
444
|
+
/**
|
|
445
|
+
* Deactivate Card
|
|
446
|
+
*
|
|
447
|
+
* Deactivate a loyalty card. Sets PURGED to true and CARDACTIVE to false.
|
|
448
|
+
* No request body required.
|
|
449
|
+
*
|
|
450
|
+
* **Required scope:** `WRITE_LOYALTY`
|
|
451
|
+
*/
|
|
452
|
+
export declare const loyaltyDeactivateCard: <ThrowOnError extends boolean = false>(options: Options<LoyaltyDeactivateCardData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyDeactivateCardResponses, LoyaltyDeactivateCardErrors, ThrowOnError, "fields">;
|
|
453
|
+
/**
|
|
454
|
+
* Update Groups
|
|
455
|
+
*
|
|
456
|
+
* Update loyalty groups assigned to a card. Groups are non-purchase loyalty groups.
|
|
457
|
+
* Use the optional `/delete` sub-path to remove groups instead of adding them.
|
|
458
|
+
*
|
|
459
|
+
* **Required scope:** `WRITE_LOYALTY`
|
|
460
|
+
*/
|
|
461
|
+
export declare const loyaltyUpdateGroups: <ThrowOnError extends boolean = false>(options: Options<LoyaltyUpdateGroupsData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyUpdateGroupsResponses, LoyaltyUpdateGroupsErrors, ThrowOnError, "fields">;
|
|
462
|
+
/**
|
|
463
|
+
* Update External User ID
|
|
464
|
+
*
|
|
465
|
+
* Update the external user ID and/or username for a loyalty card.
|
|
466
|
+
*
|
|
467
|
+
* **Required scope:** `WRITE_LOYALTY`
|
|
468
|
+
*/
|
|
469
|
+
export declare const loyaltyUpdateExternalUserId: <ThrowOnError extends boolean = false>(options: Options<LoyaltyUpdateExternalUserIdData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyUpdateExternalUserIdResponses, LoyaltyUpdateExternalUserIdErrors, ThrowOnError, "fields">;
|
|
470
|
+
/**
|
|
471
|
+
* Get Card Details with Offers
|
|
472
|
+
*
|
|
473
|
+
* Get comprehensive loyalty card information with available offers.
|
|
474
|
+
* The site code determines which offers are available. Includes both
|
|
475
|
+
* available offers and recently redeemed offers in the response.
|
|
476
|
+
*
|
|
477
|
+
* **Required scope:** `READ_LOYALTY`
|
|
478
|
+
*
|
|
479
|
+
* **Error codes:**
|
|
480
|
+
* - `4` (Not Found) - Card not found or invalid card length
|
|
481
|
+
*/
|
|
482
|
+
export declare const loyaltyGetCardWithOffers: <ThrowOnError extends boolean = false>(options: Options<LoyaltyGetCardWithOffersData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyGetCardWithOffersResponses, LoyaltyGetCardWithOffersErrors, ThrowOnError, "fields">;
|
|
483
|
+
/**
|
|
484
|
+
* Update Member Groups
|
|
485
|
+
*
|
|
486
|
+
* Update member (purchase) groups assigned to a card.
|
|
487
|
+
* Use the optional `/delete` sub-path to remove groups instead of adding them.
|
|
488
|
+
*
|
|
489
|
+
* **Required scope:** `WRITE_LOYALTY`
|
|
490
|
+
*/
|
|
491
|
+
export declare const loyaltyUpdateMemberGroups: <ThrowOnError extends boolean = false>(options: Options<LoyaltyUpdateMemberGroupsData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyUpdateMemberGroupsResponses, LoyaltyUpdateMemberGroupsErrors, ThrowOnError, "fields">;
|
|
492
|
+
/**
|
|
493
|
+
* Update Card PIN
|
|
494
|
+
*
|
|
495
|
+
* Update the PIN for a loyalty card.
|
|
496
|
+
*
|
|
497
|
+
* **Required scope:** `WRITE_LOYALTY`
|
|
498
|
+
*/
|
|
499
|
+
export declare const loyaltyUpdateCardPin: <ThrowOnError extends boolean = false>(options: Options<LoyaltyUpdateCardPinData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyUpdateCardPinResponses, LoyaltyUpdateCardPinErrors, ThrowOnError, "fields">;
|
|
500
|
+
/**
|
|
501
|
+
* Update Points
|
|
502
|
+
*
|
|
503
|
+
* Award or redeem points on a loyalty card. Use positive points to award, negative to redeem.
|
|
504
|
+
* When redeeming (negative points), the amount represents the redemption value.
|
|
505
|
+
*
|
|
506
|
+
* **Required scope:** `WRITE_LOYALTY`
|
|
507
|
+
*/
|
|
508
|
+
export declare const loyaltyUpdatePoints: <ThrowOnError extends boolean = false>(options: Options<LoyaltyUpdatePointsData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyUpdatePointsResponses, LoyaltyUpdatePointsErrors, ThrowOnError, "fields">;
|
|
509
|
+
/**
|
|
510
|
+
* Renew Card
|
|
511
|
+
*
|
|
512
|
+
* Process card renewal with payment via Stripe. Extends the card expiry date
|
|
513
|
+
* based on the card type's configured renewal period (in years).
|
|
514
|
+
*
|
|
515
|
+
* **Required scope:** `WRITE_LOYALTY`
|
|
516
|
+
*/
|
|
517
|
+
export declare const loyaltyRenewCard: <ThrowOnError extends boolean = false>(options: Options<LoyaltyRenewCardData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyRenewCardResponses, LoyaltyRenewCardErrors, ThrowOnError, "fields">;
|
|
518
|
+
/**
|
|
519
|
+
* Update Shipping Address
|
|
520
|
+
*
|
|
521
|
+
* Update shipping address for a loyalty card.
|
|
522
|
+
*
|
|
523
|
+
* **Required scope:** `WRITE_LOYALTY`
|
|
524
|
+
*/
|
|
525
|
+
export declare const loyaltyUpdateShippingAddress: <ThrowOnError extends boolean = false>(options: Options<LoyaltyUpdateShippingAddressData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyUpdateShippingAddressResponses, LoyaltyUpdateShippingAddressErrors, ThrowOnError, "fields">;
|
|
526
|
+
/**
|
|
527
|
+
* Generate Short Code
|
|
528
|
+
*
|
|
529
|
+
* Generate a new short code for a loyalty card. The short code is generated server-side
|
|
530
|
+
* and returned along with the card's public ID and wallet link.
|
|
531
|
+
*
|
|
532
|
+
* **Required scope:** `WRITE_LOYALTY`
|
|
533
|
+
*/
|
|
534
|
+
export declare const loyaltyGenerateShortCode: <ThrowOnError extends boolean = false>(options: Options<LoyaltyGenerateShortCodeData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyGenerateShortCodeResponses, LoyaltyGenerateShortCodeErrors, ThrowOnError, "fields">;
|
|
535
|
+
/**
|
|
536
|
+
* Update Card Token
|
|
537
|
+
*
|
|
538
|
+
* Update the push notification token for a loyalty card. Can also optionally
|
|
539
|
+
* update card type, external user ID, and username.
|
|
540
|
+
*
|
|
541
|
+
* **Required scope:** `WRITE_LOYALTY`
|
|
542
|
+
*/
|
|
543
|
+
export declare const loyaltyUpdateCardToken: <ThrowOnError extends boolean = false>(options: Options<LoyaltyUpdateCardTokenData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyUpdateCardTokenResponses, LoyaltyUpdateCardTokenErrors, ThrowOnError, "fields">;
|
|
544
|
+
/**
|
|
545
|
+
* Get Card Types
|
|
546
|
+
*
|
|
547
|
+
* Get available loyalty card types.
|
|
548
|
+
* Response uses `cardTypes` key (camelCase). The `version` and `loyaltyVersion` fields
|
|
549
|
+
* are embedded as pseudo-elements inside the cardTypes array.
|
|
550
|
+
* Response is returned as raw JSON without result/errormessage wrapper.
|
|
551
|
+
*
|
|
552
|
+
* **Required scope:** `READ_LOYALTY`
|
|
553
|
+
*/
|
|
554
|
+
export declare const loyaltyGetCardTypes: <ThrowOnError extends boolean = false>(options?: Options<LoyaltyGetCardTypesData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyGetCardTypesResponses, LoyaltyGetCardTypesErrors, ThrowOnError, "fields">;
|
|
555
|
+
/**
|
|
556
|
+
* Get Coffee Card Stats
|
|
557
|
+
*
|
|
558
|
+
* Get coffee card statistics for offers.
|
|
559
|
+
* Returns progress towards coffee card offers (offers with a promotion group).
|
|
560
|
+
* Card number must be between 5 and 25 characters.
|
|
561
|
+
* Response is a raw JSON array (no wrapper object).
|
|
562
|
+
*
|
|
563
|
+
* **Required scope:** `READ_LOYALTY`
|
|
564
|
+
*
|
|
565
|
+
* **Error codes:**
|
|
566
|
+
* - `8` (Missing Data) - Invalid site or invalid card
|
|
567
|
+
* - `9` (Request Rejected) - Card number too short (< 5) or too long (> 25)
|
|
568
|
+
*/
|
|
569
|
+
export declare const loyaltyGetCoffeeCardStats: <ThrowOnError extends boolean = false>(options: Options<LoyaltyGetCoffeeCardStatsData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyGetCoffeeCardStatsResponses, LoyaltyGetCoffeeCardStatsErrors, ThrowOnError, "fields">;
|
|
570
|
+
/**
|
|
571
|
+
* Get Compulsory Fields
|
|
572
|
+
*
|
|
573
|
+
* Get compulsory field configuration.
|
|
574
|
+
* Response is returned as raw JSON without result/errormessage wrapper.
|
|
575
|
+
*
|
|
576
|
+
* **Required scope:** `READ_LOYALTY`
|
|
577
|
+
*/
|
|
578
|
+
export declare const loyaltyGetCompulsoryFields: <ThrowOnError extends boolean = false>(options?: Options<LoyaltyGetCompulsoryFieldsData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyGetCompulsoryFieldsResponses, LoyaltyGetCompulsoryFieldsErrors, ThrowOnError, "fields">;
|
|
579
|
+
/**
|
|
580
|
+
* Get Loyalty Groups
|
|
581
|
+
*
|
|
582
|
+
* Get available loyalty groups (non-purchase groups).
|
|
583
|
+
* Response uses `cardGroups` key. The `version` and `loyaltyVersion` fields
|
|
584
|
+
* are embedded as pseudo-elements inside the cardGroups array.
|
|
585
|
+
* Response is returned as raw JSON without result/errormessage wrapper.
|
|
586
|
+
*
|
|
587
|
+
* **Required scope:** `READ_LOYALTY`
|
|
588
|
+
*
|
|
589
|
+
* **Error codes:**
|
|
590
|
+
* - `4` (Not Found) - No groups found
|
|
591
|
+
*/
|
|
592
|
+
export declare const loyaltyGetGroups: <ThrowOnError extends boolean = false>(options?: Options<LoyaltyGetGroupsData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyGetGroupsResponses, LoyaltyGetGroupsErrors, ThrowOnError, "fields">;
|
|
593
|
+
/**
|
|
594
|
+
* Get Card Image
|
|
595
|
+
*
|
|
596
|
+
* Get loyalty card barcode image URL.
|
|
597
|
+
* Card number must be between 5 and 13 characters.
|
|
598
|
+
* Response is returned as raw JSON without result/errormessage wrapper.
|
|
599
|
+
*
|
|
600
|
+
* **Required scope:** `READ_LOYALTY`
|
|
601
|
+
*/
|
|
602
|
+
export declare const loyaltyGetCardImage: <ThrowOnError extends boolean = false>(options: Options<LoyaltyGetCardImageData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyGetCardImageResponses, LoyaltyGetCardImageErrors, ThrowOnError, "fields">;
|
|
603
|
+
/**
|
|
604
|
+
* Get Member Groups
|
|
605
|
+
*
|
|
606
|
+
* Get available member groups (purchase groups).
|
|
607
|
+
* Response uses `membergroups` key. The `version` and `loyaltyVersion` fields
|
|
608
|
+
* are embedded as pseudo-elements inside the membergroups array.
|
|
609
|
+
* Response is returned as raw JSON without result/errormessage wrapper.
|
|
610
|
+
*
|
|
611
|
+
* **Required scope:** `READ_LOYALTY`
|
|
612
|
+
*
|
|
613
|
+
* **Error codes:**
|
|
614
|
+
* - `4` (Not Found) - No groups found
|
|
615
|
+
*/
|
|
616
|
+
export declare const loyaltyGetMemberGroups: <ThrowOnError extends boolean = false>(options?: Options<LoyaltyGetMemberGroupsData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyGetMemberGroupsResponses, LoyaltyGetMemberGroupsErrors, ThrowOnError, "fields">;
|
|
617
|
+
/**
|
|
618
|
+
* Calculate Points for Items
|
|
619
|
+
*
|
|
620
|
+
* Calculate points for a transaction with line items.
|
|
621
|
+
* Returns the calculated points for the given items and total.
|
|
622
|
+
* Body is wrapped in a `card` key.
|
|
623
|
+
*
|
|
624
|
+
* **Required scope:** `WRITE_LOYALTY`
|
|
625
|
+
*/
|
|
626
|
+
export declare const loyaltyCreatePointsTransaction: <ThrowOnError extends boolean = false>(options: Options<LoyaltyCreatePointsTransactionData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyCreatePointsTransactionResponses, LoyaltyCreatePointsTransactionErrors, ThrowOnError, "fields">;
|
|
627
|
+
/**
|
|
628
|
+
* Recover Card PIN
|
|
629
|
+
*
|
|
630
|
+
* Trigger password/PIN recovery for a loyalty card. Sends a recovery email
|
|
631
|
+
* to the card's registered email address. If the card has no PIN set,
|
|
632
|
+
* a random one is generated first.
|
|
633
|
+
*
|
|
634
|
+
* **Required scope:** `READ_LOYALTY`
|
|
635
|
+
*
|
|
636
|
+
* **Error codes:**
|
|
637
|
+
* - `0` (OK) - Recovery email sent successfully
|
|
638
|
+
* - `4` (Not Found) - Card not found, invalid card length, no email on file, or email marked as bad
|
|
639
|
+
*/
|
|
640
|
+
export declare const loyaltyGetCardRecovery: <ThrowOnError extends boolean = false>(options: Options<LoyaltyGetCardRecoveryData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyGetCardRecoveryResponses, LoyaltyGetCardRecoveryErrors, ThrowOnError, "fields">;
|
|
641
|
+
/**
|
|
642
|
+
* Search Cards
|
|
643
|
+
*
|
|
644
|
+
* Search for loyalty cards by various criteria.
|
|
645
|
+
* The search term can be passed either as a query string parameter or
|
|
646
|
+
* as the 4th path segment (e.g., `/search/mobile/0412345678`).
|
|
647
|
+
* Also supports short codes (6-character alphanumeric codes) as the search term,
|
|
648
|
+
* which are automatically detected regardless of command.
|
|
649
|
+
* Response is returned as raw JSON without result/errormessage wrapper.
|
|
650
|
+
*
|
|
651
|
+
* **Required scope:** `READ_LOYALTY`
|
|
652
|
+
*
|
|
653
|
+
* **Supported search commands:**
|
|
654
|
+
* - `card` - Search by card number (partial match)
|
|
655
|
+
* - `cardmatch` - Exact card number match
|
|
656
|
+
* - `customernumber` - Search by customer number (partial match)
|
|
657
|
+
* - `first` - Search by first name (partial match)
|
|
658
|
+
* - `last` - Search by last name (partial match)
|
|
659
|
+
* - `name` - Search by full name (supports "surname, firstname" or single term)
|
|
660
|
+
* - `email` - Search by email (partial match)
|
|
661
|
+
* - `emailmatch` - Exact email match
|
|
662
|
+
* - `username` - Exact username match
|
|
663
|
+
* - `mobile` - Search by mobile (partial match, leading 0 stripped)
|
|
664
|
+
* - `mobilematch` - Exact mobile match (converted to E.164 format)
|
|
665
|
+
* - `homephone` / `phone` - Search by home phone (partial match)
|
|
666
|
+
* - `workphone` / `work` - Search by work phone (partial match)
|
|
667
|
+
* - `gender` - Filter by gender (exact match)
|
|
668
|
+
* - `postcode` - Search by postcode (partial match)
|
|
669
|
+
* - `changed` - Cards changed since date (max 3 months back)
|
|
670
|
+
* - `home` / `homesite` - Filter by home site code (exact match)
|
|
671
|
+
* - `birthmonth` - Filter by birth month (1-12)
|
|
672
|
+
* - `age` - Filter by age
|
|
673
|
+
* - `occupation` - Search by occupation (partial match)
|
|
674
|
+
* - `soft1` through `soft10` - Search by custom soft fields (partial match)
|
|
675
|
+
* - `emailopt` - Filter by email opt-in flag (T/F)
|
|
676
|
+
* - `smsopt` - Filter by SMS opt-in flag (T/F)
|
|
677
|
+
* - `cardtype` - Filter by card type
|
|
678
|
+
* - `pointsgreater` - Cards with points balance >= value
|
|
679
|
+
* - `pointsless` - Cards with points balance <= value
|
|
680
|
+
* - `loyaltygroup` - Cards belonging to a loyalty group ID
|
|
681
|
+
*
|
|
682
|
+
* **Error codes:**
|
|
683
|
+
* - `4` (Not Found) - No results found, missing search term, or invalid command
|
|
684
|
+
*/
|
|
685
|
+
export declare const loyaltySearchCards: <ThrowOnError extends boolean = false>(options: Options<LoyaltySearchCardsData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltySearchCardsResponses, LoyaltySearchCardsErrors, ThrowOnError, "fields">;
|
|
686
|
+
/**
|
|
687
|
+
* Get Loyalty Settings
|
|
688
|
+
*
|
|
689
|
+
* Get loyalty system settings including card types and groups.
|
|
690
|
+
* Response is returned as raw JSON without result/errormessage wrapper.
|
|
691
|
+
*
|
|
692
|
+
* **Required scope:** `READ_LOYALTY`
|
|
693
|
+
*/
|
|
694
|
+
export declare const loyaltyGetSettings: <ThrowOnError extends boolean = false>(options?: Options<LoyaltyGetSettingsData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyGetSettingsResponses, LoyaltyGetSettingsErrors, ThrowOnError, "fields">;
|
|
695
|
+
/**
|
|
696
|
+
* Get Sync List
|
|
697
|
+
*
|
|
698
|
+
* Get loyalty sync list — returns email and card number pairs for active cards.
|
|
699
|
+
* Optionally filter by card type using the path parameter.
|
|
700
|
+
* Response uses `cards` key. The `version` and `loyaltyVersion` fields
|
|
701
|
+
* are embedded as pseudo-elements inside the cards array.
|
|
702
|
+
* Response is returned as raw JSON without result/errormessage wrapper.
|
|
703
|
+
*
|
|
704
|
+
* **Required scope:** `READ_LOYALTY`
|
|
705
|
+
*
|
|
706
|
+
* **Error codes:**
|
|
707
|
+
* - `4` (Not Found) - No cards found
|
|
708
|
+
*/
|
|
709
|
+
export declare const loyaltyGetSyncList: <ThrowOnError extends boolean = false>(options?: Options<LoyaltyGetSyncListData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyGetSyncListResponses, LoyaltyGetSyncListErrors, ThrowOnError, "fields">;
|
|
710
|
+
/**
|
|
711
|
+
* Update Sync List
|
|
712
|
+
*
|
|
713
|
+
* Update sync list information.
|
|
714
|
+
*
|
|
715
|
+
* **Required scope:** `WRITE_LOYALTY`
|
|
716
|
+
*/
|
|
717
|
+
export declare const loyaltyUpdateSyncList: <ThrowOnError extends boolean = false>(options: Options<LoyaltyUpdateSyncListData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyUpdateSyncListResponses, LoyaltyUpdateSyncListErrors, ThrowOnError, "fields">;
|
|
718
|
+
/**
|
|
719
|
+
* Get Sync List by Card Type
|
|
720
|
+
*
|
|
721
|
+
* Get loyalty sync list filtered by card type.
|
|
722
|
+
*
|
|
723
|
+
* **Required scope:** `READ_LOYALTY`
|
|
724
|
+
*/
|
|
725
|
+
export declare const loyaltyGetSyncListByCommand: <ThrowOnError extends boolean = false>(options: Options<LoyaltyGetSyncListByCommandData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyGetSyncListByCommandResponses, LoyaltyGetSyncListByCommandErrors, ThrowOnError, "fields">;
|
|
726
|
+
/**
|
|
727
|
+
* Verify Card
|
|
728
|
+
*
|
|
729
|
+
* Verify a loyalty card against a PIN and retrieve full card details if verification succeeds.
|
|
730
|
+
* The card field can be a card number or an email address (if it contains `@`, lookup is by email).
|
|
731
|
+
* PIN is checked against the stored PIN first, then falls back to card number, mobile, or email
|
|
732
|
+
* based on company settings.
|
|
733
|
+
* Response is returned as raw JSON without result/errormessage wrapper.
|
|
734
|
+
*
|
|
735
|
+
* **Required scope:** `WRITE_LOYALTY`
|
|
736
|
+
*/
|
|
737
|
+
export declare const loyaltyVerifyCard: <ThrowOnError extends boolean = false>(options: Options<LoyaltyVerifyCardData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyVerifyCardResponses, LoyaltyVerifyCardErrors, ThrowOnError, "fields">;
|
|
738
|
+
/**
|
|
739
|
+
* Get Wallet Link
|
|
740
|
+
*
|
|
741
|
+
* Get digital wallet link for a loyalty card
|
|
742
|
+
*/
|
|
743
|
+
export declare const loyaltyGetWalletLink: <ThrowOnError extends boolean = false>(options: Options<LoyaltyGetWalletLinkData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<LoyaltyGetWalletLinkResponses, LoyaltyGetWalletLinkErrors, ThrowOnError, "fields">;
|
|
744
|
+
/**
|
|
745
|
+
* Create Member
|
|
746
|
+
*
|
|
747
|
+
* Create a new member.
|
|
748
|
+
* The request body must be wrapped in a `member` key: `{"member": {...}}`.
|
|
749
|
+
* Either email or mobile must be provided. If neither the member number nor
|
|
750
|
+
* email/mobile is provided, returns MISSING_DATA.
|
|
751
|
+
*
|
|
752
|
+
* Phone numbers can be provided either as flat fields (mobile, phone, phone1)
|
|
753
|
+
* or nested in a phones object ({phones: {mobile, home, work}}).
|
|
754
|
+
* If phones object is provided, phones.home -> phone, phones.work -> phone1.
|
|
755
|
+
*
|
|
756
|
+
* If `createcard` is true, a virtual loyalty card is created.
|
|
757
|
+
* If `billingtoken` or `billingcustomerid` is provided, auto-charge signup is triggered.
|
|
758
|
+
*
|
|
759
|
+
* **Required scope:** `WRITE_MEMBERSHIP`
|
|
760
|
+
*
|
|
761
|
+
* **Error codes:**
|
|
762
|
+
* - `0` (OK) - Member created successfully
|
|
763
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
764
|
+
* - `6` (Invalid Email) - Email format validation failed
|
|
765
|
+
* - `7` (Invalid Mobile) - Mobile number too short or invalid format
|
|
766
|
+
* - `8` (Missing Data) - Body missing or both email and mobile missing
|
|
767
|
+
* - `11` (Database Error) - Failed to insert/update customer record
|
|
768
|
+
* - `18` (Card Exists) - Member number already exists
|
|
769
|
+
* - `45` (Invalid JSON) - Request body is not valid JSON
|
|
770
|
+
* - `47` (Member Exists Same Email) - A member with this email already exists
|
|
771
|
+
* - `48` (Member Exists Same Mobile) - A member with this mobile already exists
|
|
772
|
+
*/
|
|
773
|
+
export declare const membershipCreateMember: <ThrowOnError extends boolean = false>(options: Options<MembershipCreateMemberData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<MembershipCreateMemberResponses, MembershipCreateMemberErrors, ThrowOnError, "fields">;
|
|
774
|
+
/**
|
|
775
|
+
* Get Allowed Functions
|
|
776
|
+
*
|
|
777
|
+
* Get list of allowed membership functions for the current API key.
|
|
778
|
+
* Returns an object keyed by feature name, each mapping to an array of allowed HTTP methods.
|
|
779
|
+
*
|
|
780
|
+
* **Required scope:** `READ_MEMBERSHIP`
|
|
781
|
+
*
|
|
782
|
+
* **Error codes:**
|
|
783
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
784
|
+
* - `3` (Invalid Function) - Invalid sub-function
|
|
785
|
+
*/
|
|
786
|
+
export declare const membershipGetAllowedFunctions: <ThrowOnError extends boolean = false>(options?: Options<MembershipGetAllowedFunctionsData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<MembershipGetAllowedFunctionsResponses, MembershipGetAllowedFunctionsErrors, ThrowOnError, "fields">;
|
|
787
|
+
/**
|
|
788
|
+
* Get Member by Card
|
|
789
|
+
*
|
|
790
|
+
* Get comprehensive member information by loyalty card number.
|
|
791
|
+
* Looks up the customernumber from CUSTLOY by card number, then returns the
|
|
792
|
+
* same full member detail as GET /membership/member/{memberNumber}.
|
|
793
|
+
*
|
|
794
|
+
* **Required scope:** `READ_MEMBERSHIP`
|
|
795
|
+
*
|
|
796
|
+
* **Error codes:**
|
|
797
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
798
|
+
* - `4` (Not Found) - Card not found or member not found
|
|
799
|
+
*/
|
|
800
|
+
export declare const membershipGetMemberByCard: <ThrowOnError extends boolean = false>(options: Options<MembershipGetMemberByCardData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<MembershipGetMemberByCardResponses, MembershipGetMemberByCardErrors, ThrowOnError, "fields">;
|
|
801
|
+
/**
|
|
802
|
+
* Update Member by Card
|
|
803
|
+
*
|
|
804
|
+
* Update member information via card number.
|
|
805
|
+
* Route: PUT /membership/card/{cardNumber}
|
|
806
|
+
*
|
|
807
|
+
* Same as PUT /membership/member/{memberNumber} but looks up the member
|
|
808
|
+
* by loyalty card number first. When using the card path, CUSTLOY fields
|
|
809
|
+
* are also updated and group assignments can be managed.
|
|
810
|
+
*
|
|
811
|
+
* **Required scope:** `WRITE_MEMBERSHIP`
|
|
812
|
+
*/
|
|
813
|
+
export declare const membershipUpdateMemberByCard: <ThrowOnError extends boolean = false>(options: Options<MembershipUpdateMemberByCardData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<MembershipUpdateMemberByCardResponses, MembershipUpdateMemberByCardErrors, ThrowOnError, "fields">;
|
|
814
|
+
/**
|
|
815
|
+
* Get Member Groups
|
|
816
|
+
*
|
|
817
|
+
* Get available membership groups (purchase groups).
|
|
818
|
+
* Returns groups from LOYALTYGROUP where PURCHASEGROUP = 'T'.
|
|
819
|
+
* Columns LINKEDCARD, LINKED_CUSTOMER_LOYALTY_ID, SHAREPER, VENUETOPAY, PURCHASEGROUP
|
|
820
|
+
* are removed. IMAGEURL is renamed to `url`. All keys are lowercased.
|
|
821
|
+
* The `version` and `loyaltyVersion` fields are embedded as pseudo-elements inside the groups array.
|
|
822
|
+
* Both `groups` and `membergroups` sub-function paths are supported and return the same data.
|
|
823
|
+
*
|
|
824
|
+
* **Required scope:** `READ_MEMBERSHIP`
|
|
825
|
+
*
|
|
826
|
+
* **Error codes:**
|
|
827
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
828
|
+
* - `4` (Not Found) - No groups found
|
|
829
|
+
*/
|
|
830
|
+
export declare const membershipGetMemberGroups: <ThrowOnError extends boolean = false>(options?: Options<MembershipGetMemberGroupsData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<MembershipGetMemberGroupsResponses, MembershipGetMemberGroupsErrors, ThrowOnError, "fields">;
|
|
831
|
+
/**
|
|
832
|
+
* Get Member Details
|
|
833
|
+
*
|
|
834
|
+
* Get comprehensive member information by member number (customernumber).
|
|
835
|
+
* Returns full member details from the CUSTOMER table, plus associated loyalty cards
|
|
836
|
+
* from CUSTLOY, member groups from LOYCARDGROUP/LOYALTYGROUP, and customer orders
|
|
837
|
+
* from CUSTORDER. The response does NOT include result/errormessage wrapper fields.
|
|
838
|
+
*
|
|
839
|
+
* The `version` and `loyaltyVersion` fields are embedded inside the member object.
|
|
840
|
+
*
|
|
841
|
+
* The member/{id}/search/{type}/{from}/{to} sub-path allows filtering orders by
|
|
842
|
+
* date range or amount range.
|
|
843
|
+
*
|
|
844
|
+
* **Required scope:** `READ_MEMBERSHIP`
|
|
845
|
+
*
|
|
846
|
+
* **Error codes:**
|
|
847
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
848
|
+
* - `4` (Not Found) - Member not found, or card number invalid (length must be 1-25)
|
|
849
|
+
*/
|
|
850
|
+
export declare const membershipGetMember: <ThrowOnError extends boolean = false>(options: Options<MembershipGetMemberData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<MembershipGetMemberResponses, MembershipGetMemberErrors, ThrowOnError, "fields">;
|
|
851
|
+
/**
|
|
852
|
+
* Update Member
|
|
853
|
+
*
|
|
854
|
+
* Update member information (general update).
|
|
855
|
+
* Route: PUT /membership/member/{memberNumber}
|
|
856
|
+
*
|
|
857
|
+
* The request body must be wrapped in a `member` key: `{"member": {...}}`.
|
|
858
|
+
* Updates the CUSTOMER record and optionally the CUSTLOY record (when using card sub-function).
|
|
859
|
+
*
|
|
860
|
+
* When using the `card` sub-function path, additional CUSTLOY fields are updated
|
|
861
|
+
* (email, dateofbirth, firstname, lastname, mobile, phone, postcode, gender)
|
|
862
|
+
* and group assignments can be managed.
|
|
863
|
+
*
|
|
864
|
+
* If `createcard` is true and no card exists, a virtual loyalty card is created.
|
|
865
|
+
* If `billingtoken` or `billingcustomerid` is provided, auto-charge signup is triggered.
|
|
866
|
+
*
|
|
867
|
+
* **Required scope:** `WRITE_MEMBERSHIP`
|
|
868
|
+
*
|
|
869
|
+
* **Error codes:**
|
|
870
|
+
* - `0` (OK) - Member updated successfully
|
|
871
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
872
|
+
* - `4` (Not Found) - Member not found
|
|
873
|
+
* - `8` (Missing Data) - Body missing
|
|
874
|
+
* - `11` (Database Error) - Failed to update customer record
|
|
875
|
+
* - `45` (Invalid JSON) - Request body is not valid JSON
|
|
876
|
+
*/
|
|
877
|
+
export declare const membershipUpdateMember: <ThrowOnError extends boolean = false>(options: Options<MembershipUpdateMemberData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<MembershipUpdateMemberResponses, MembershipUpdateMemberErrors, ThrowOnError, "fields">;
|
|
878
|
+
/**
|
|
879
|
+
* Activate Member
|
|
880
|
+
*
|
|
881
|
+
* Activate a member.
|
|
882
|
+
* Route: PUT /membership/member/{memberNumber}/activate
|
|
883
|
+
* Sets MEMBERSTATUS to 'A' (Active).
|
|
884
|
+
* No request body is required.
|
|
885
|
+
*
|
|
886
|
+
* **Required scope:** `WRITE_MEMBERSHIP`
|
|
887
|
+
*
|
|
888
|
+
* **Error codes:**
|
|
889
|
+
* - `0` (OK) - Member activated successfully
|
|
890
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
891
|
+
* - `4` (Not Found) - Member not found
|
|
892
|
+
* - `11` (Database Error) - Failed to update status
|
|
893
|
+
*/
|
|
894
|
+
export declare const membershipActivateMember: <ThrowOnError extends boolean = false>(options: Options<MembershipActivateMemberData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<MembershipActivateMemberResponses, MembershipActivateMemberErrors, ThrowOnError, "fields">;
|
|
895
|
+
/**
|
|
896
|
+
* Update Member Address
|
|
897
|
+
*
|
|
898
|
+
* Update member billing and/or shipping address.
|
|
899
|
+
* Route: PUT /membership/member/{memberNumber}/address
|
|
900
|
+
* Updates billing address, shipping address, and/or delivery instructions.
|
|
901
|
+
* At least one of billing, shipping, or deliveryinstruction must be provided.
|
|
902
|
+
*
|
|
903
|
+
* **Required scope:** `WRITE_MEMBERSHIP`
|
|
904
|
+
*
|
|
905
|
+
* **Error codes:**
|
|
906
|
+
* - `0` (OK) - Address updated successfully
|
|
907
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
908
|
+
* - `4` (Not Found) - Member not found
|
|
909
|
+
* - `8` (Missing Data) - Body missing or no address data provided
|
|
910
|
+
* - `11` (Database Error) - Failed to update address
|
|
911
|
+
* - `45` (Invalid JSON) - Request body is not valid JSON
|
|
912
|
+
*/
|
|
913
|
+
export declare const membershipUpdateMemberAddress: <ThrowOnError extends boolean = false>(options: Options<MembershipUpdateMemberAddressData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<MembershipUpdateMemberAddressResponses, MembershipUpdateMemberAddressErrors, ThrowOnError, "fields">;
|
|
914
|
+
/**
|
|
915
|
+
* Update Billing Address
|
|
916
|
+
*
|
|
917
|
+
* Update member billing address only.
|
|
918
|
+
* Route: PUT /membership/member/{memberNumber}/billingaddress
|
|
919
|
+
*
|
|
920
|
+
* **Required scope:** `WRITE_MEMBERSHIP`
|
|
921
|
+
*
|
|
922
|
+
* **Error codes:**
|
|
923
|
+
* - `0` (OK) - Billing address updated successfully
|
|
924
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
925
|
+
* - `4` (Not Found) - Member not found
|
|
926
|
+
* - `8` (Missing Data) - Body missing or billing data not provided
|
|
927
|
+
* - `11` (Database Error) - Failed to update billing address
|
|
928
|
+
* - `45` (Invalid JSON) - Request body is not valid JSON
|
|
929
|
+
*/
|
|
930
|
+
export declare const membershipUpdateBillingAddress: <ThrowOnError extends boolean = false>(options: Options<MembershipUpdateBillingAddressData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<MembershipUpdateBillingAddressResponses, MembershipUpdateBillingAddressErrors, ThrowOnError, "fields">;
|
|
931
|
+
/**
|
|
932
|
+
* Cancel Member
|
|
933
|
+
*
|
|
934
|
+
* Cancel a member.
|
|
935
|
+
* Route: PUT /membership/member/{memberNumber}/cancel
|
|
936
|
+
* Sets MEMBERSTATUS to 'C' (Cancelled).
|
|
937
|
+
* No request body is required.
|
|
938
|
+
*
|
|
939
|
+
* **Required scope:** `WRITE_MEMBERSHIP`
|
|
940
|
+
*
|
|
941
|
+
* **Error codes:**
|
|
942
|
+
* - `0` (OK) - Member cancelled successfully
|
|
943
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
944
|
+
* - `4` (Not Found) - Member not found
|
|
945
|
+
* - `11` (Database Error) - Failed to update status
|
|
946
|
+
*/
|
|
947
|
+
export declare const membershipCancelMember: <ThrowOnError extends boolean = false>(options: Options<MembershipCancelMemberData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<MembershipCancelMemberResponses, MembershipCancelMemberErrors, ThrowOnError, "fields">;
|
|
948
|
+
/**
|
|
949
|
+
* Replace Credit Card
|
|
950
|
+
*
|
|
951
|
+
* Replace member credit card token.
|
|
952
|
+
* Route: PUT /membership/member/{memberNumber}/replacecreditcard
|
|
953
|
+
* Updates the TOKEN field in the CUSTOMER table with the new card token.
|
|
954
|
+
*
|
|
955
|
+
* **Required scope:** `WRITE_MEMBERSHIP`
|
|
956
|
+
*
|
|
957
|
+
* **Error codes:**
|
|
958
|
+
* - `0` (OK) - Card token replaced successfully
|
|
959
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
960
|
+
* - `4` (Not Found) - Member not found
|
|
961
|
+
* - `8` (Missing Data) - Body missing or cardtoken field empty
|
|
962
|
+
* - `11` (Database Error) - Failed to update token
|
|
963
|
+
* - `45` (Invalid JSON) - Request body is not valid JSON
|
|
964
|
+
*/
|
|
965
|
+
export declare const membershipReplaceCreditCard: <ThrowOnError extends boolean = false>(options: Options<MembershipReplaceCreditCardData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<MembershipReplaceCreditCardResponses, MembershipReplaceCreditCardErrors, ThrowOnError, "fields">;
|
|
966
|
+
/**
|
|
967
|
+
* Update Shipping Address
|
|
968
|
+
*
|
|
969
|
+
* Update member shipping address only.
|
|
970
|
+
* Route: PUT /membership/member/{memberNumber}/shippingaddress
|
|
971
|
+
*
|
|
972
|
+
* **Required scope:** `WRITE_MEMBERSHIP`
|
|
973
|
+
*
|
|
974
|
+
* **Error codes:**
|
|
975
|
+
* - `0` (OK) - Shipping address updated successfully
|
|
976
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
977
|
+
* - `4` (Not Found) - Member not found
|
|
978
|
+
* - `8` (Missing Data) - Body missing or shipping data not provided
|
|
979
|
+
* - `11` (Database Error) - Failed to update shipping address
|
|
980
|
+
* - `45` (Invalid JSON) - Request body is not valid JSON
|
|
981
|
+
*/
|
|
982
|
+
export declare const membershipUpdateShippingAddress: <ThrowOnError extends boolean = false>(options: Options<MembershipUpdateShippingAddressData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<MembershipUpdateShippingAddressResponses, MembershipUpdateShippingAddressErrors, ThrowOnError, "fields">;
|
|
983
|
+
/**
|
|
984
|
+
* Suspend Member
|
|
985
|
+
*
|
|
986
|
+
* Suspend a member.
|
|
987
|
+
* Route: PUT /membership/member/{memberNumber}/suspend
|
|
988
|
+
* Sets MEMBERSTATUS to 'S' (Suspended).
|
|
989
|
+
* No request body is required.
|
|
990
|
+
*
|
|
991
|
+
* **Required scope:** `WRITE_MEMBERSHIP`
|
|
992
|
+
*
|
|
993
|
+
* **Error codes:**
|
|
994
|
+
* - `0` (OK) - Member suspended successfully
|
|
995
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
996
|
+
* - `4` (Not Found) - Member not found
|
|
997
|
+
* - `11` (Database Error) - Failed to update status
|
|
998
|
+
*/
|
|
999
|
+
export declare const membershipSuspendMember: <ThrowOnError extends boolean = false>(options: Options<MembershipSuspendMemberData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<MembershipSuspendMemberResponses, MembershipSuspendMemberErrors, ThrowOnError, "fields">;
|
|
1000
|
+
/**
|
|
1001
|
+
* Update Member Token
|
|
1002
|
+
*
|
|
1003
|
+
* Update member authentication token.
|
|
1004
|
+
* Route: PUT /membership/member/{memberNumber}/token
|
|
1005
|
+
* Updates the TOKEN field in the CUSTOMER table.
|
|
1006
|
+
*
|
|
1007
|
+
* **Required scope:** `WRITE_MEMBERSHIP`
|
|
1008
|
+
*
|
|
1009
|
+
* **Error codes:**
|
|
1010
|
+
* - `0` (OK) - Token updated successfully
|
|
1011
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
1012
|
+
* - `4` (Not Found) - Member not found
|
|
1013
|
+
* - `8` (Missing Data) - Body missing
|
|
1014
|
+
* - `11` (Database Error) - Failed to update token
|
|
1015
|
+
* - `45` (Invalid JSON) - Request body is not valid JSON
|
|
1016
|
+
*/
|
|
1017
|
+
export declare const membershipUpdateMemberToken: <ThrowOnError extends boolean = false>(options: Options<MembershipUpdateMemberTokenData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<MembershipUpdateMemberTokenResponses, MembershipUpdateMemberTokenErrors, ThrowOnError, "fields">;
|
|
1018
|
+
/**
|
|
1019
|
+
* Get Member Groups (alternate)
|
|
1020
|
+
*
|
|
1021
|
+
* Get available membership groups (alternate route).
|
|
1022
|
+
* Same as GET /membership/groups.
|
|
1023
|
+
*
|
|
1024
|
+
* **Required scope:** `READ_MEMBERSHIP`
|
|
1025
|
+
*/
|
|
1026
|
+
export declare const membershipGetMemberGroupsAlt: <ThrowOnError extends boolean = false>(options?: Options<MembershipGetMemberGroupsAltData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<MembershipGetMemberGroupsAltResponses, MembershipGetMemberGroupsAltErrors, ThrowOnError, "fields">;
|
|
1027
|
+
/**
|
|
1028
|
+
* Search Members
|
|
1029
|
+
*
|
|
1030
|
+
* Search for members by various criteria.
|
|
1031
|
+
* Returns a simplified member record for each match (max 500 results).
|
|
1032
|
+
* The response does NOT include result/errormessage wrapper fields.
|
|
1033
|
+
* The `version` and `loyaltyVersion` fields are embedded as pseudo-elements inside the members array.
|
|
1034
|
+
*
|
|
1035
|
+
* Supported search commands:
|
|
1036
|
+
* - `number` or `customer` - Search by card number (LIKE match)
|
|
1037
|
+
* - `name` - Search by name (case-insensitive LIKE match)
|
|
1038
|
+
* - `email` - Search by email (case-insensitive LIKE match)
|
|
1039
|
+
* - `mobile` - Search by mobile number (LIKE match)
|
|
1040
|
+
* - `phone` - Search by home or work phone (PHONE or PHONE1, LIKE match)
|
|
1041
|
+
* - `gender` - Search by exact gender code
|
|
1042
|
+
* - `postcode` - Search by billing or shipping postcode (case-insensitive LIKE match)
|
|
1043
|
+
* - `changed` - Search by date changed (members changed since the given date, max 3 months back)
|
|
1044
|
+
* - `birthmonth` - Search by birth month (1-12)
|
|
1045
|
+
* - `age` - Search by age
|
|
1046
|
+
*
|
|
1047
|
+
* **Required scope:** `READ_MEMBERSHIP`
|
|
1048
|
+
*
|
|
1049
|
+
* **Error codes:**
|
|
1050
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
1051
|
+
* - `4` (Not Found) - Missing search command, missing query string, invalid command, or no results found
|
|
1052
|
+
*/
|
|
1053
|
+
export declare const membershipSearchMembers: <ThrowOnError extends boolean = false>(options: Options<MembershipSearchMembersData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<MembershipSearchMembersResponses, MembershipSearchMembersErrors, ThrowOnError, "fields">;
|
|
1054
|
+
/**
|
|
1055
|
+
* Create an Offer
|
|
1056
|
+
*
|
|
1057
|
+
* Create a new offer in the system.
|
|
1058
|
+
*
|
|
1059
|
+
* Requires scope: `write:offers`
|
|
1060
|
+
*/
|
|
1061
|
+
export declare const offerCreate: <ThrowOnError extends boolean = false>(options: Options<OfferCreateData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<OfferCreateResponses, OfferCreateErrors, ThrowOnError, "fields">;
|
|
1062
|
+
/**
|
|
1063
|
+
* List Offer Redemptions
|
|
1064
|
+
*
|
|
1065
|
+
* Get a list of offer redemptions with optional date range and limit filtering.
|
|
1066
|
+
* Only the GET method is supported.
|
|
1067
|
+
*
|
|
1068
|
+
* Requires scope: `read:offers`
|
|
1069
|
+
*/
|
|
1070
|
+
export declare const offerRedemptionsList: <ThrowOnError extends boolean = false>(options?: Options<OfferRedemptionsListData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<OfferRedemptionsListResponses, OfferRedemptionsListErrors, ThrowOnError, "fields">;
|
|
1071
|
+
/**
|
|
1072
|
+
* Get Offer Coffee Card Stats
|
|
1073
|
+
*
|
|
1074
|
+
* Returns coffee card statistics for a specific offer and loyalty card, showing progress towards offer completion
|
|
1075
|
+
*/
|
|
1076
|
+
export declare const offerGetCoffeeCardStats: <ThrowOnError extends boolean = false>(options: Options<OfferGetCoffeeCardStatsData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<OfferGetCoffeeCardStatsResponses, OfferGetCoffeeCardStatsErrors, ThrowOnError, "fields">;
|
|
1077
|
+
/**
|
|
1078
|
+
* List all Offers
|
|
1079
|
+
*
|
|
1080
|
+
* List all offers or filter by a loyalty card.
|
|
1081
|
+
*
|
|
1082
|
+
* Requires scope: `read:offers`
|
|
1083
|
+
*/
|
|
1084
|
+
export declare const offerList: <ThrowOnError extends boolean = false>(options: Options<OfferListData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<OfferListResponses, OfferListErrors, ThrowOnError, "fields">;
|
|
1085
|
+
/**
|
|
1086
|
+
* Delete an Offer
|
|
1087
|
+
*
|
|
1088
|
+
* Delete an offer from the system.
|
|
1089
|
+
*
|
|
1090
|
+
* Requires scope: `delete:offers`
|
|
1091
|
+
*/
|
|
1092
|
+
export declare const offerDelete: <ThrowOnError extends boolean = false>(options: Options<OfferDeleteData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<OfferDeleteResponses, OfferDeleteErrors, ThrowOnError, "fields">;
|
|
1093
|
+
/**
|
|
1094
|
+
* Update an Offer
|
|
1095
|
+
*
|
|
1096
|
+
* Update an existing offer in the system.
|
|
1097
|
+
* You can send partial updates to this endpoint, provide only the data you wish to change.
|
|
1098
|
+
*
|
|
1099
|
+
* Requires scope: `write:offers`
|
|
1100
|
+
*/
|
|
1101
|
+
export declare const offerUpdate: <ThrowOnError extends boolean = false>(options: Options<OfferUpdateData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<OfferUpdateResponses, OfferUpdateErrors, ThrowOnError, "fields">;
|
|
1102
|
+
/**
|
|
1103
|
+
* Delete Order
|
|
1104
|
+
*
|
|
1105
|
+
* Delete an order (soft delete - sets status to 'D').
|
|
1106
|
+
*
|
|
1107
|
+
* Marks the order as deleted by setting ORDERSTATUS to 'D'.
|
|
1108
|
+
* The order record is not physically removed from the database.
|
|
1109
|
+
*
|
|
1110
|
+
* **Required scope:** `DELETE_ORDER`
|
|
1111
|
+
*
|
|
1112
|
+
* **Error codes:**
|
|
1113
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
1114
|
+
* - `8` (Missing Data) - Body missing
|
|
1115
|
+
* - `9` (Request Rejected) - Order does not exist
|
|
1116
|
+
* - `11` (Database Error) - Database error during deletion
|
|
1117
|
+
* - `12` (Invalid Site) - Site not part of company
|
|
1118
|
+
* - `45` (Invalid JSON) - Request body is not valid JSON
|
|
1119
|
+
*/
|
|
1120
|
+
export declare const orderDeleteOrder: <ThrowOnError extends boolean = false>(options: Options<OrderDeleteOrderData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<OrderDeleteOrderResponses, OrderDeleteOrderErrors, ThrowOnError, "fields">;
|
|
1121
|
+
/**
|
|
1122
|
+
* Create Order
|
|
1123
|
+
*
|
|
1124
|
+
* Create a new order.
|
|
1125
|
+
*
|
|
1126
|
+
* Creates a new customer order with line items. Either `card` or `customer`
|
|
1127
|
+
* (or both) must be provided. If both are provided, they must be linked to
|
|
1128
|
+
* the same customer.
|
|
1129
|
+
*
|
|
1130
|
+
* If the order number is omitted, one will be auto-generated. If a delivery
|
|
1131
|
+
* address is provided and shipping is enabled, the order may be automatically
|
|
1132
|
+
* shipped to distribution.
|
|
1133
|
+
*
|
|
1134
|
+
* **Required scope:** `WRITE_ORDER`
|
|
1135
|
+
*
|
|
1136
|
+
* **Error codes:**
|
|
1137
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
1138
|
+
* - `8` (Missing Data) - Body missing, missing card/customer, no delivery address, no items
|
|
1139
|
+
* - `9` (Request Rejected) - Order exists, card/customer not linked, item not found, customer not found
|
|
1140
|
+
* - `11` (Database Error) - Database error during creation
|
|
1141
|
+
* - `12` (Invalid Site) - Site not part of company
|
|
1142
|
+
* - `45` (Invalid JSON) - Request body is not valid JSON
|
|
1143
|
+
*/
|
|
1144
|
+
export declare const orderCreateOrder: <ThrowOnError extends boolean = false>(options: Options<OrderCreateOrderData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<OrderCreateOrderResponses, OrderCreateOrderErrors, ThrowOnError, "fields">;
|
|
1145
|
+
/**
|
|
1146
|
+
* Get Allowed Functions
|
|
1147
|
+
*
|
|
1148
|
+
* Get list of allowed order functions for the current API key.
|
|
1149
|
+
*
|
|
1150
|
+
* Returns a nested object with the API version and allowed HTTP methods
|
|
1151
|
+
* for each feature (allowedFunctions, settings, search).
|
|
1152
|
+
*
|
|
1153
|
+
* **Required scope:** `READ_ORDER`
|
|
1154
|
+
*
|
|
1155
|
+
* **Error codes:**
|
|
1156
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
1157
|
+
*/
|
|
1158
|
+
export declare const orderGetAllowedFunctions: <ThrowOnError extends boolean = false>(options?: Options<OrderGetAllowedFunctionsData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<OrderGetAllowedFunctionsResponses, OrderGetAllowedFunctionsErrors, ThrowOnError, "fields">;
|
|
1159
|
+
/**
|
|
1160
|
+
* Search Orders
|
|
1161
|
+
*
|
|
1162
|
+
* Search for orders by various criteria.
|
|
1163
|
+
*
|
|
1164
|
+
* Returns up to 500 matching orders. The search is case-insensitive
|
|
1165
|
+
* for text fields. Pass site as -1 to search across all sites.
|
|
1166
|
+
*
|
|
1167
|
+
* **Required scope:** `READ_ORDER`
|
|
1168
|
+
*
|
|
1169
|
+
* **Search commands (case-insensitive):**
|
|
1170
|
+
* - `card` - Search by loyalty card number (partial match)
|
|
1171
|
+
* - `customer` - Search by customer number (partial match)
|
|
1172
|
+
* - `name` - Search by customer name (partial match)
|
|
1173
|
+
* - `email` - Search by email address (partial match)
|
|
1174
|
+
* - `emailmatch` - Search by exact email address
|
|
1175
|
+
* - `status` - Search by order status code
|
|
1176
|
+
* - `order` - Search by order number (partial match)
|
|
1177
|
+
* - `mobile` - Search by mobile number (partial match)
|
|
1178
|
+
* - `phone` / `homephone` - Search by home phone number (partial match)
|
|
1179
|
+
* - `deposit` - Search by minimum deposit amount
|
|
1180
|
+
* - `total` - Search by minimum order total
|
|
1181
|
+
* - `work` / `workphone` - Search by work phone number (partial match)
|
|
1182
|
+
* - `postcode` - Search by shipping postcode (partial match)
|
|
1183
|
+
* - `changed` - Search by modified date (max 3 months back)
|
|
1184
|
+
*
|
|
1185
|
+
* **Error codes:**
|
|
1186
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
1187
|
+
* - `4` (Not Found) - Missing search criteria or no orders match
|
|
1188
|
+
*/
|
|
1189
|
+
export declare const orderSearchOrders: <ThrowOnError extends boolean = false>(options: Options<OrderSearchOrdersData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<OrderSearchOrdersResponses, OrderSearchOrdersErrors, ThrowOnError, "fields">;
|
|
1190
|
+
/**
|
|
1191
|
+
* Get Order Details
|
|
1192
|
+
*
|
|
1193
|
+
* Get order details by order number and site.
|
|
1194
|
+
*
|
|
1195
|
+
* Returns full order details including customer information, delivery
|
|
1196
|
+
* address, and all line items. Customer data is sourced from the
|
|
1197
|
+
* CUSTOMER table and includes billing/shipping addresses.
|
|
1198
|
+
*
|
|
1199
|
+
* **Required scope:** `READ_ORDER`
|
|
1200
|
+
*
|
|
1201
|
+
* **Error codes:**
|
|
1202
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
1203
|
+
* - `4` (Not Found) - Order not found
|
|
1204
|
+
*/
|
|
1205
|
+
export declare const orderGetOrder: <ThrowOnError extends boolean = false>(options: Options<OrderGetOrderData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<OrderGetOrderResponses, OrderGetOrderErrors, ThrowOnError, "fields">;
|
|
1206
|
+
/**
|
|
1207
|
+
* Ping
|
|
1208
|
+
*
|
|
1209
|
+
* Use this endpoint to verify your connection and credentials to the
|
|
1210
|
+
* Zen server.
|
|
1211
|
+
*/
|
|
1212
|
+
export declare const pingPing: <ThrowOnError extends boolean = false>(options?: Options<PingPingData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<PingPingResponses, PingPingErrors, ThrowOnError, "fields">;
|
|
1213
|
+
/**
|
|
1214
|
+
* Get Sites Information
|
|
1215
|
+
*
|
|
1216
|
+
* Get complete company and site information.
|
|
1217
|
+
*
|
|
1218
|
+
* Returns company details (from CHAIN, CHAININFO, CHAINDEFAULT, CHAINLOCALE tables)
|
|
1219
|
+
* along with all sites and their locations. Only the GET method is supported.
|
|
1220
|
+
*
|
|
1221
|
+
* **Required scope:** `READ_SITES`
|
|
1222
|
+
*
|
|
1223
|
+
* **Error codes:**
|
|
1224
|
+
* - `3` (Invalid Function) - Non-GET method used
|
|
1225
|
+
* - `4` (Not Found) - Company or sites not found
|
|
1226
|
+
*/
|
|
1227
|
+
export declare const sitesGetSites: <ThrowOnError extends boolean = false>(options?: Options<SitesGetSitesData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<SitesGetSitesResponses, SitesGetSitesErrors, ThrowOnError, "fields">;
|
|
1228
|
+
/**
|
|
1229
|
+
* Get Stripe Configuration
|
|
1230
|
+
*
|
|
1231
|
+
* Get Stripe public key configuration.
|
|
1232
|
+
*
|
|
1233
|
+
* Returns the Stripe public key configured for the company.
|
|
1234
|
+
*
|
|
1235
|
+
* Required scope: `read:stripe`
|
|
1236
|
+
*/
|
|
1237
|
+
export declare const stripeGetStripeConfig: <ThrowOnError extends boolean = false>(options?: Options<StripeGetStripeConfigData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<StripeGetStripeConfigResponses, StripeGetStripeConfigErrors, ThrowOnError, "fields">;
|
|
1238
|
+
/**
|
|
1239
|
+
* Get Transaction Details
|
|
1240
|
+
*
|
|
1241
|
+
* Get transaction details by site, location, terminal, journal and date.
|
|
1242
|
+
*
|
|
1243
|
+
* The response is returned directly via `prepareJson()` without `result`/`errormessage`
|
|
1244
|
+
* wrapper fields. All integer values are converted to strings.
|
|
1245
|
+
*
|
|
1246
|
+
* When `format=event` is specified, returns a JournalCreatedEvent serialization
|
|
1247
|
+
* instead of the standard transaction structure.
|
|
1248
|
+
*
|
|
1249
|
+
* The response conditionally includes:
|
|
1250
|
+
* - `customer` - when a loyalty card was used or customer data is available from POS
|
|
1251
|
+
* - `salesdiscount` - when a sales discount was applied
|
|
1252
|
+
* - `offers` - when offers were redeemed
|
|
1253
|
+
*
|
|
1254
|
+
* **Required scope:** `read:transaction`
|
|
1255
|
+
*
|
|
1256
|
+
* **Error codes:**
|
|
1257
|
+
* - `4` (Not Found) - Transaction basket not found
|
|
1258
|
+
* - `8` (Missing Data) - Required query parameters missing, or invalid site, or journal not found (event format)
|
|
1259
|
+
* - `12` (Invalid Site) - Site not part of company
|
|
1260
|
+
*/
|
|
1261
|
+
export declare const transactionGetTransaction: <ThrowOnError extends boolean = false>(options: Options<TransactionGetTransactionData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<TransactionGetTransactionResponses, TransactionGetTransactionErrors, ThrowOnError, "fields">;
|
|
1262
|
+
/**
|
|
1263
|
+
* Create Transaction
|
|
1264
|
+
*
|
|
1265
|
+
* Create a new transaction record.
|
|
1266
|
+
*
|
|
1267
|
+
* Submit a transaction from the POS terminal. The request body must be wrapped
|
|
1268
|
+
* in a `transaction` key. The payload shape varies depending on the scenario -
|
|
1269
|
+
* see the examples for common use cases including basic sales, loyalty, vouchers,
|
|
1270
|
+
* debtor charges, and refunds.
|
|
1271
|
+
*
|
|
1272
|
+
* **Required scope:** `write:transaction`
|
|
1273
|
+
*
|
|
1274
|
+
* **Error codes:**
|
|
1275
|
+
* - `0` (OK) - Transaction submitted for processing
|
|
1276
|
+
* - `8` (Missing Data) - Body missing, missing site/terminal/journal/date/time/operator/operatorname/operatorlogin, invalid serial number, date older than 180 days
|
|
1277
|
+
* - `9` (Request Rejected) - Journal already exists, same transaction pending, voucher number missing, unable to save transaction
|
|
1278
|
+
* - `12` (Invalid Site) - Site not part of company
|
|
1279
|
+
* - `45` (Invalid JSON) - Request body is not valid JSON
|
|
1280
|
+
*/
|
|
1281
|
+
export declare const transactionCreateTransaction: <ThrowOnError extends boolean = false>(options: Options<TransactionCreateTransactionData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<TransactionCreateTransactionResponses, TransactionCreateTransactionErrors, ThrowOnError, "fields">;
|
|
1282
|
+
/**
|
|
1283
|
+
* Validate Email Address
|
|
1284
|
+
*
|
|
1285
|
+
* Validates an email address by checking:
|
|
1286
|
+
* 1. Email format validity
|
|
1287
|
+
* 2. Domain has valid MX records
|
|
1288
|
+
*
|
|
1289
|
+
* Returns detailed validation results including overall validity status.
|
|
1290
|
+
*
|
|
1291
|
+
* **Error codes:**
|
|
1292
|
+
* * `8` (Missing Data) - Request body is empty or `email` field is missing
|
|
1293
|
+
* * `3` (Invalid Function) - Request method is not POST
|
|
1294
|
+
*/
|
|
1295
|
+
export declare const emailValidationValidateEmail: <ThrowOnError extends boolean = false>(options: Options<EmailValidationValidateEmailData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<EmailValidationValidateEmailResponses, EmailValidationValidateEmailErrors, ThrowOnError, "fields">;
|
|
1296
|
+
/**
|
|
1297
|
+
* Get Version Information
|
|
1298
|
+
*
|
|
1299
|
+
* Get API version information and available function sections
|
|
1300
|
+
*/
|
|
1301
|
+
export declare const versionGetVersion: <ThrowOnError extends boolean = false>(options?: Options<VersionGetVersionData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<VersionGetVersionResponses, VersionGetVersionErrors, ThrowOnError, "fields">;
|
|
1302
|
+
/**
|
|
1303
|
+
* Delete Voucher
|
|
1304
|
+
*
|
|
1305
|
+
* Delete (cancel) a voucher. Sets the voucher status to 'C' (Cancelled).
|
|
1306
|
+
*
|
|
1307
|
+
* Requires the voucher serial number, PIN (for verification when enabled),
|
|
1308
|
+
* and site code. The voucher record is not physically removed.
|
|
1309
|
+
*
|
|
1310
|
+
* Request body must be wrapped in a `voucher` key: `{"voucher": {...}}`.
|
|
1311
|
+
*
|
|
1312
|
+
* **Required scope:** `DELETE_VOUCHER`
|
|
1313
|
+
*
|
|
1314
|
+
* **Error codes:**
|
|
1315
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
1316
|
+
* - `4` (Not Found) - Voucher not found
|
|
1317
|
+
* - `8` (Missing Data) - Body missing, missing serial number, missing PIN, missing site, invalid site
|
|
1318
|
+
* - `9` (Request Rejected) - Invalid PIN
|
|
1319
|
+
* - `11` (Database Error) - Database error during deletion
|
|
1320
|
+
* - `45` (Invalid JSON) - Request body is not valid JSON
|
|
1321
|
+
*/
|
|
1322
|
+
export declare const voucherDeleteVoucher: <ThrowOnError extends boolean = false>(options: Options<VoucherDeleteVoucherData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<VoucherDeleteVoucherResponses, VoucherDeleteVoucherErrors, ThrowOnError, "fields">;
|
|
1323
|
+
/**
|
|
1324
|
+
* Get Voucher Type
|
|
1325
|
+
*
|
|
1326
|
+
* Get voucher type information.
|
|
1327
|
+
*
|
|
1328
|
+
* Returns all settings for the specified voucher type from the VOUCHERTYPE table.
|
|
1329
|
+
* If the voucher type path segment is omitted, defaults to 'Gift'.
|
|
1330
|
+
*
|
|
1331
|
+
* **Required scope:** `READ_VOUCHER`
|
|
1332
|
+
*
|
|
1333
|
+
* **Error codes:**
|
|
1334
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
1335
|
+
* - `4` (Not Found) - Voucher type not found
|
|
1336
|
+
*/
|
|
1337
|
+
export declare const voucherGetVoucherType: <ThrowOnError extends boolean = false>(options: Options<VoucherGetVoucherTypeData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<VoucherGetVoucherTypeResponses, VoucherGetVoucherTypeErrors, ThrowOnError, "fields">;
|
|
1338
|
+
/**
|
|
1339
|
+
* Create Voucher
|
|
1340
|
+
*
|
|
1341
|
+
* Create a new voucher. If the serial number is omitted and the company has
|
|
1342
|
+
* lead characters configured, a serial number will be auto-generated.
|
|
1343
|
+
*
|
|
1344
|
+
* For web vouchers (`isWebVoucher: true`), payment charge information including
|
|
1345
|
+
* a `processId` from the payment gateway is required. Duplicate processIds
|
|
1346
|
+
* will be rejected.
|
|
1347
|
+
*
|
|
1348
|
+
* Request body must be wrapped in a `voucher` key: `{"voucher": {...}}`.
|
|
1349
|
+
*
|
|
1350
|
+
* **Required scope:** `WRITE_VOUCHER`
|
|
1351
|
+
*
|
|
1352
|
+
* **Error codes:**
|
|
1353
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
1354
|
+
* - `8` (Missing Data) - Body missing, missing amount, missing site, missing voucher number
|
|
1355
|
+
* - `9` (Request Rejected) - Voucher exists, invalid amount, invalid terminal, duplicate payment, missing payment info
|
|
1356
|
+
* - `11` (Database Error) - Database error during creation
|
|
1357
|
+
* - `45` (Invalid JSON) - Request body is not valid JSON
|
|
1358
|
+
*/
|
|
1359
|
+
export declare const voucherCreateVoucher: <ThrowOnError extends boolean = false>(options: Options<VoucherCreateVoucherData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<VoucherCreateVoucherResponses, VoucherCreateVoucherErrors, ThrowOnError, "fields">;
|
|
1360
|
+
/**
|
|
1361
|
+
* Enquire Voucher
|
|
1362
|
+
*
|
|
1363
|
+
* Enquire about a voucher's current status, balance, and transaction history.
|
|
1364
|
+
* Returns detailed voucher information including up to 50 most recent transactions.
|
|
1365
|
+
*
|
|
1366
|
+
* PIN verification may be required depending on company settings. POS requests
|
|
1367
|
+
* (`ispos: true`) bypass PIN checking. The `READ_VOUCHER_PINLESS` scope also
|
|
1368
|
+
* bypasses PIN checking.
|
|
1369
|
+
*
|
|
1370
|
+
* Vouchers in Cancelled (C), Locked (L), or Written Off (W) status will be rejected
|
|
1371
|
+
* (though for enquire, expiry is NOT checked unlike other operations).
|
|
1372
|
+
*
|
|
1373
|
+
* Request body must be wrapped in a `voucher` key: `{"voucher": {...}}`.
|
|
1374
|
+
*
|
|
1375
|
+
* **Required scope:** `WRITE_VOUCHER`
|
|
1376
|
+
*
|
|
1377
|
+
* **Voucher Status Codes:**
|
|
1378
|
+
*
|
|
1379
|
+
* | Code | Status |
|
|
1380
|
+
* |------|--------|
|
|
1381
|
+
* | A | Available |
|
|
1382
|
+
* | S | Sold |
|
|
1383
|
+
* | Z | Recharged |
|
|
1384
|
+
* | R | Redeemed |
|
|
1385
|
+
* | P | Part Redeemed |
|
|
1386
|
+
* | G | Given Away |
|
|
1387
|
+
* | C | Cancelled |
|
|
1388
|
+
* | L | Locked |
|
|
1389
|
+
* | H | Pending Sale |
|
|
1390
|
+
* | r | Pending Full Redeem |
|
|
1391
|
+
* | p | Pending Part Redeem |
|
|
1392
|
+
* | I | Import |
|
|
1393
|
+
* | W | Written Off |
|
|
1394
|
+
* | E | Portal Edit |
|
|
1395
|
+
*/
|
|
1396
|
+
export declare const voucherEnquireVoucher: <ThrowOnError extends boolean = false>(options: Options<VoucherEnquireVoucherData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<VoucherEnquireVoucherResponses, VoucherEnquireVoucherErrors, ThrowOnError, "fields">;
|
|
1397
|
+
/**
|
|
1398
|
+
* Get Voucher Image
|
|
1399
|
+
*
|
|
1400
|
+
* Get voucher barcode image URL.
|
|
1401
|
+
*
|
|
1402
|
+
* Returns a URL to the barcode image for the specified voucher serial number.
|
|
1403
|
+
* If the image does not exist, it will be generated on demand.
|
|
1404
|
+
* Serial number must be between 4 and 13 characters.
|
|
1405
|
+
*
|
|
1406
|
+
* **Required scope:** `READ_VOUCHER`
|
|
1407
|
+
*
|
|
1408
|
+
* **Error codes:**
|
|
1409
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
1410
|
+
* - `9` (Request Rejected) - Serial number length out of range (4-13 chars)
|
|
1411
|
+
*/
|
|
1412
|
+
export declare const voucherGetVoucherImage: <ThrowOnError extends boolean = false>(options: Options<VoucherGetVoucherImageData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<VoucherGetVoucherImageResponses, VoucherGetVoucherImageErrors, ThrowOnError, "fields">;
|
|
1413
|
+
/**
|
|
1414
|
+
* Recharge Voucher
|
|
1415
|
+
*
|
|
1416
|
+
* Recharge (top up) an existing voucher with additional funds.
|
|
1417
|
+
*
|
|
1418
|
+
* For web vouchers (`isWebVoucher: true`), payment charge information including
|
|
1419
|
+
* a `processId` from the payment gateway is required. Duplicate payments
|
|
1420
|
+
* (same `processId`) will be rejected.
|
|
1421
|
+
*
|
|
1422
|
+
* Auto-recharge settings, payment option, and token are preserved from the
|
|
1423
|
+
* existing voucher record and cannot be changed via this endpoint.
|
|
1424
|
+
*
|
|
1425
|
+
* Supports gift recharges (`isgift: true`) where the recharge notification
|
|
1426
|
+
* is sent to a different recipient. Optional message fields can be included.
|
|
1427
|
+
*
|
|
1428
|
+
* PIN is not validated for recharge operations.
|
|
1429
|
+
*
|
|
1430
|
+
* Request body must be wrapped in a `voucher` key: `{"voucher": {...}}`.
|
|
1431
|
+
*
|
|
1432
|
+
* **Required scope:** `WRITE_VOUCHER`
|
|
1433
|
+
*
|
|
1434
|
+
* **Error codes:**
|
|
1435
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
1436
|
+
* - `4` (Not Found) - Voucher not found
|
|
1437
|
+
* - `8` (Missing Data) - Missing amount, missing site, body missing
|
|
1438
|
+
* - `9` (Request Rejected) - Invalid amount, voucher expired, invalid state, invalid terminal, duplicate payment, missing payment info
|
|
1439
|
+
* - `11` (Database Error) - Database error during recharge
|
|
1440
|
+
* - `45` (Invalid JSON) - Request body is not valid JSON
|
|
1441
|
+
*/
|
|
1442
|
+
export declare const voucherRechargeVoucher: <ThrowOnError extends boolean = false>(options: Options<VoucherRechargeVoucherData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<VoucherRechargeVoucherResponses, VoucherRechargeVoucherErrors, ThrowOnError, "fields">;
|
|
1443
|
+
/**
|
|
1444
|
+
* Redeem Voucher
|
|
1445
|
+
*
|
|
1446
|
+
* Redeem an amount from a voucher. The redemption amount must not exceed the
|
|
1447
|
+
* available balance. Expired, cancelled, locked, or written-off vouchers
|
|
1448
|
+
* cannot be redeemed.
|
|
1449
|
+
*
|
|
1450
|
+
* For POS requests (`ispos: true`), `location` and `terminal` are required
|
|
1451
|
+
* and a `reference` (site:terminal:journal) is included in the response.
|
|
1452
|
+
*
|
|
1453
|
+
* Request body must be wrapped in a `voucher` key: `{"voucher": {...}}`.
|
|
1454
|
+
*
|
|
1455
|
+
* **Required scope:** `WRITE_VOUCHER`
|
|
1456
|
+
*
|
|
1457
|
+
* **Error codes:**
|
|
1458
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
1459
|
+
* - `4` (Not Found) - Voucher not found
|
|
1460
|
+
* - `8` (Missing Data) - Missing amount, missing site, invalid site, body missing
|
|
1461
|
+
* - `9` (Request Rejected) - Invalid amount, insufficient balance, voucher expired, invalid state, invalid PIN, invalid terminal
|
|
1462
|
+
* - `11` (Database Error) - Database error during redemption
|
|
1463
|
+
* - `45` (Invalid JSON) - Request body is not valid JSON
|
|
1464
|
+
*/
|
|
1465
|
+
export declare const voucherRedeemVoucher: <ThrowOnError extends boolean = false>(options: Options<VoucherRedeemVoucherData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<VoucherRedeemVoucherResponses, VoucherRedeemVoucherErrors, ThrowOnError, "fields">;
|
|
1466
|
+
/**
|
|
1467
|
+
* Release Voucher Reserve
|
|
1468
|
+
*
|
|
1469
|
+
* Release a previously reserved amount on a voucher, making the funds
|
|
1470
|
+
* available again. The release amount must not exceed the currently
|
|
1471
|
+
* reserved amount.
|
|
1472
|
+
*
|
|
1473
|
+
* Request body must be wrapped in a `voucher` key: `{"voucher": {...}}`.
|
|
1474
|
+
*
|
|
1475
|
+
* **Required scope:** `WRITE_VOUCHER`
|
|
1476
|
+
*
|
|
1477
|
+
* **Error codes:**
|
|
1478
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
1479
|
+
* - `4` (Not Found) - Voucher not found
|
|
1480
|
+
* - `8` (Missing Data) - Missing amount, body missing
|
|
1481
|
+
* - `9` (Request Rejected) - Invalid amount, release exceeds reserved, no current reserve, voucher expired, invalid state
|
|
1482
|
+
* - `11` (Database Error) - Database error during release
|
|
1483
|
+
* - `45` (Invalid JSON) - Request body is not valid JSON
|
|
1484
|
+
*/
|
|
1485
|
+
export declare const voucherReleaseVoucher: <ThrowOnError extends boolean = false>(options: Options<VoucherReleaseVoucherData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<VoucherReleaseVoucherResponses, VoucherReleaseVoucherErrors, ThrowOnError, "fields">;
|
|
1486
|
+
/**
|
|
1487
|
+
* Reserve Voucher Amount
|
|
1488
|
+
*
|
|
1489
|
+
* Reserve an amount on a voucher, reducing its available balance without
|
|
1490
|
+
* actually redeeming it. The reserved amount can later be redeemed or released.
|
|
1491
|
+
*
|
|
1492
|
+
* The reserve amount must not exceed the current available balance
|
|
1493
|
+
* (value - used - pending).
|
|
1494
|
+
*
|
|
1495
|
+
* Request body must be wrapped in a `voucher` key: `{"voucher": {...}}`.
|
|
1496
|
+
*
|
|
1497
|
+
* **Required scope:** `WRITE_VOUCHER`
|
|
1498
|
+
*
|
|
1499
|
+
* **Error codes:**
|
|
1500
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
1501
|
+
* - `4` (Not Found) - Voucher not found
|
|
1502
|
+
* - `8` (Missing Data) - Missing amount, body missing
|
|
1503
|
+
* - `9` (Request Rejected) - Invalid amount, insufficient balance, voucher expired, invalid state, invalid PIN
|
|
1504
|
+
* - `11` (Database Error) - Database error during reserve
|
|
1505
|
+
* - `45` (Invalid JSON) - Request body is not valid JSON
|
|
1506
|
+
*/
|
|
1507
|
+
export declare const voucherReserveVoucher: <ThrowOnError extends boolean = false>(options: Options<VoucherReserveVoucherData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<VoucherReserveVoucherResponses, VoucherReserveVoucherErrors, ThrowOnError, "fields">;
|
|
1508
|
+
/**
|
|
1509
|
+
* Search Vouchers
|
|
1510
|
+
*
|
|
1511
|
+
* Search for vouchers by various criteria.
|
|
1512
|
+
*
|
|
1513
|
+
* Returns up to 150 matching vouchers. The search value is passed as the
|
|
1514
|
+
* raw query string (e.g., `/voucher/Gift/search/number?V12345`).
|
|
1515
|
+
*
|
|
1516
|
+
* For the non-flat endpoint, the response includes a `version` key inside
|
|
1517
|
+
* the `vouchers` object alongside the numeric-indexed items.
|
|
1518
|
+
*
|
|
1519
|
+
* When searching for 'Gift' type, both 'Gift' and 'GiveAway' vouchers
|
|
1520
|
+
* are included in results.
|
|
1521
|
+
*
|
|
1522
|
+
* **Required scope:** `READ_VOUCHER`
|
|
1523
|
+
*
|
|
1524
|
+
* **Error codes:**
|
|
1525
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
1526
|
+
* - `4` (Not Found) - Missing search criteria or no vouchers found
|
|
1527
|
+
*/
|
|
1528
|
+
export declare const voucherSearchVouchers: <ThrowOnError extends boolean = false>(options: Options<VoucherSearchVouchersData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<VoucherSearchVouchersResponses, VoucherSearchVouchersErrors, ThrowOnError, "fields">;
|
|
1529
|
+
/**
|
|
1530
|
+
* Search Vouchers (Flat Format)
|
|
1531
|
+
*
|
|
1532
|
+
* Search for vouchers (flattened response format).
|
|
1533
|
+
*
|
|
1534
|
+
* Same as the regular search but without the `version` key in the response.
|
|
1535
|
+
* Returns up to 150 matching vouchers.
|
|
1536
|
+
*
|
|
1537
|
+
* **Required scope:** `READ_VOUCHER`
|
|
1538
|
+
*
|
|
1539
|
+
* **Error codes:**
|
|
1540
|
+
* - `1` (Invalid Access Key) - Invalid or missing API key/scope
|
|
1541
|
+
* - `4` (Not Found) - Missing search criteria or no vouchers found
|
|
1542
|
+
*/
|
|
1543
|
+
export declare const voucherSearchVouchersFlat: <ThrowOnError extends boolean = false>(options: Options<VoucherSearchVouchersFlatData, ThrowOnError>) => import("./client/types.gen.js").RequestResult<VoucherSearchVouchersFlatResponses, VoucherSearchVouchersFlatErrors, ThrowOnError, "fields">;
|
|
1544
|
+
//# sourceMappingURL=sdk.gen.d.ts.map
|