mcp-zenskar 1.1.0 → 1.1.1
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 +194 -41
- package/package.json +1 -1
- package/src/mcp-config.json +109 -49
package/README.md
CHANGED
|
@@ -1,15 +1,22 @@
|
|
|
1
1
|
# Zenskar MCP Server
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
##
|
|
6
|
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
-
|
|
11
|
-
-
|
|
12
|
-
-
|
|
3
|
+
MCP server for the Zenskar API. 103 tools covering customers, contracts, invoices, payments, credit notes, accounting, products, plans, quotes, and more.
|
|
4
|
+
|
|
5
|
+
## What it does
|
|
6
|
+
|
|
7
|
+
- Customers: list, search, create, update, addresses, contacts, payment methods
|
|
8
|
+
- Contracts: create, read, update, delete, amend, add phases and pricing, expire
|
|
9
|
+
- Invoices: list, get, approve, void, generate, credit notes, download
|
|
10
|
+
- Payments: create, edit, refund, delete, auto-charge
|
|
11
|
+
- Credit notes: list, create (standalone or against invoice), get by ID
|
|
12
|
+
- Accounting: chart of accounts, journal entries and lines, balance sheet, income statement, account balances
|
|
13
|
+
- Products: CRUD, pricing configurations
|
|
14
|
+
- Plans: list, create, add products, preview estimates
|
|
15
|
+
- Quotes: create, preview, accept (converts to contract)
|
|
16
|
+
- Business entities: list, get, create, update
|
|
17
|
+
- Jobs: monitor async operations
|
|
18
|
+
- Custom attributes and tax categories
|
|
19
|
+
- Multi-tenant, supports Bearer token and API key auth
|
|
13
20
|
|
|
14
21
|
## Installation
|
|
15
22
|
|
|
@@ -51,7 +58,7 @@ npx mcp-zenskar
|
|
|
51
58
|
This MCP server requires two authentication parameters for every request:
|
|
52
59
|
|
|
53
60
|
1. **Organization ID**: Your Zenskar organization identifier
|
|
54
|
-
2. **Authorization Token**: Your API Bearer token
|
|
61
|
+
2. **Authorization Token**: Your API Bearer token or API key
|
|
55
62
|
|
|
56
63
|
### Getting Your Credentials
|
|
57
64
|
|
|
@@ -68,47 +75,193 @@ Once configured, you can ask Claude to interact with your Zenskar data:
|
|
|
68
75
|
|
|
69
76
|
```
|
|
70
77
|
"Show me my recent customers"
|
|
71
|
-
"
|
|
72
|
-
"
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
Each tool requires authentication parameters:
|
|
78
|
-
|
|
79
|
-
```javascript
|
|
80
|
-
{
|
|
81
|
-
"organization": "your-org-id",
|
|
82
|
-
"authorization": "Bearer your-token",
|
|
83
|
-
// ... other tool-specific parameters
|
|
84
|
-
}
|
|
78
|
+
"Find the contract for Acme Corp and add a $500/month add-on phase"
|
|
79
|
+
"Create a $25 credit note against the latest invoice for customer X"
|
|
80
|
+
"Show me the balance sheet and income statement"
|
|
81
|
+
"List all products and their pricing configurations"
|
|
82
|
+
"Record a $1000 manual payment against invoice Y"
|
|
85
83
|
```
|
|
86
84
|
|
|
87
85
|
## Available Tools
|
|
88
86
|
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
87
|
+
### Customers
|
|
88
|
+
| Tool | Description |
|
|
89
|
+
|---|---|
|
|
90
|
+
| `listCustomers` | List customers with search, filtering, and pagination |
|
|
91
|
+
| `getCustomerById` | Get a customer by ID |
|
|
92
|
+
| `createCustomer` | Create a customer with address and tax info |
|
|
93
|
+
| `updateCustomer` | Update customer details (partial update) |
|
|
94
|
+
|
|
95
|
+
### Contacts
|
|
96
|
+
| Tool | Description |
|
|
97
|
+
|---|---|
|
|
98
|
+
| `listContacts` | List contacts with pagination |
|
|
99
|
+
| `getContactById` | Get a contact by ID |
|
|
100
|
+
| `createContact` | Create a contact for a customer |
|
|
101
|
+
| `updateContact` | Update a contact's details |
|
|
102
|
+
|
|
103
|
+
### Contracts
|
|
104
|
+
| Tool | Description |
|
|
105
|
+
|---|---|
|
|
106
|
+
| `listContracts` | List contracts with filtering by status, customer, dates |
|
|
107
|
+
| `getContractById` | Get a contract with phases, pricings, and customer details |
|
|
108
|
+
| `createContract` | Create a contract with phases and pricing |
|
|
109
|
+
| `updateContract` | Update contract terms, status, pricing, or renewal policy |
|
|
110
|
+
| `deleteContract` | Delete a draft contract |
|
|
111
|
+
| `getContractAmendments` | Get amendment history for a contract |
|
|
112
|
+
| `createContractPhase` | Add a phase to a contract (add-ons, expansions) |
|
|
113
|
+
| `createContractPhasePricing` | Add pricing to a contract phase |
|
|
114
|
+
| `expireContract` | Expire an active contract |
|
|
115
|
+
| `createContractPrompt` | Create a contract prompt |
|
|
116
|
+
| `extractContractFromRaw` | Extract contract data from raw text using AI |
|
|
117
|
+
|
|
118
|
+
### Invoices
|
|
119
|
+
| Tool | Description |
|
|
120
|
+
|---|---|
|
|
121
|
+
| `listInvoices` | List invoices with filtering by customer, status, dates |
|
|
122
|
+
| `getInvoiceById` | Get an invoice by ID |
|
|
123
|
+
| `getInvoiceByExternalId` | Get an invoice by external ID |
|
|
124
|
+
| `getInvoiceGenerationStatus` | Check invoice generation status |
|
|
125
|
+
| `downloadInvoice` | Download invoice in JSON format |
|
|
126
|
+
| `getInvoiceContractJsonActuals` | Get contract actuals for an invoice |
|
|
127
|
+
| `getInvoicePayments` | Get payments for an invoice |
|
|
128
|
+
| `getInvoicePaymentsById` | Get a specific payment on an invoice |
|
|
129
|
+
| `getInvoicePaymentsWithoutRefunds` | Get invoice payments excluding refunds |
|
|
130
|
+
| `getInvoiceLineItems` | Get invoice line items and pricing details |
|
|
131
|
+
| `getInvoiceSummary` | Get invoice summary |
|
|
132
|
+
| `getAllInvoiceTags` | Get all available invoice tags |
|
|
133
|
+
| `generateInvoicePaymentLink` | Generate a payment link for an invoice |
|
|
134
|
+
| `payInvoice` | Initiate payment for an invoice |
|
|
135
|
+
| `approveInvoice` | Approve an invoice for billing |
|
|
136
|
+
| `voidInvoice` | Void an approved unpaid invoice |
|
|
137
|
+
| `generateInvoice` | Generate an invoice for a contract and date range |
|
|
138
|
+
| `createInvoiceCreditNote` | Create a credit note against an invoice |
|
|
139
|
+
| `createInvoiceCharge` | Auto-charge an invoice via payment gateway |
|
|
140
|
+
|
|
141
|
+
### Payments
|
|
142
|
+
| Tool | Description |
|
|
143
|
+
|---|---|
|
|
144
|
+
| `listAllPayments` | List all payments with filtering and sorting |
|
|
145
|
+
| `getPaymentById` | Get a payment by ID |
|
|
146
|
+
| `createPayment` | Record a payment against an invoice |
|
|
147
|
+
| `updatePayment` | Update a payment's status or details |
|
|
148
|
+
| `deleteManualPayment` | Delete a manual payment |
|
|
149
|
+
| `editManualPayment` | Edit a manual payment's amount or method |
|
|
150
|
+
| `refundPayment` | Refund a payment (full or partial) |
|
|
151
|
+
|
|
152
|
+
### Credit Notes
|
|
153
|
+
| Tool | Description |
|
|
154
|
+
|---|---|
|
|
155
|
+
| `listCreditNotes` | List credit notes with pagination |
|
|
156
|
+
| `getCreditNoteById` | Get a credit note by ID |
|
|
157
|
+
| `createCreditNote` | Create a standalone credit note |
|
|
158
|
+
|
|
159
|
+
### Products and Pricing
|
|
160
|
+
| Tool | Description |
|
|
161
|
+
|---|---|
|
|
162
|
+
| `listProducts` | List products in the catalog |
|
|
163
|
+
| `getProductById` | Get a product by ID |
|
|
164
|
+
| `createProduct` | Create a product |
|
|
165
|
+
| `updateProduct` | Update a product's details |
|
|
166
|
+
| `getProductPricings` | Get pricing configs for a product |
|
|
167
|
+
| `createProductPricing` | Create a pricing config for a product |
|
|
168
|
+
|
|
169
|
+
### Plans (Templates)
|
|
170
|
+
| Tool | Description |
|
|
171
|
+
|---|---|
|
|
172
|
+
| `listPlans` | List plan templates |
|
|
173
|
+
| `getPlanById` | Get a plan by ID with phases and pricing |
|
|
174
|
+
| `createPlan` | Create a plan template |
|
|
175
|
+
| `addProductsToPlan` | Add products to an existing plan |
|
|
176
|
+
| `previewPlanEstimate` | Preview estimated billing for a plan |
|
|
177
|
+
|
|
178
|
+
### Accounting
|
|
179
|
+
| Tool | Description |
|
|
180
|
+
|---|---|
|
|
181
|
+
| `getChartOfAccounts` | Get the full chart of accounts |
|
|
182
|
+
| `listAccounts` | List GL accounts with filtering |
|
|
183
|
+
| `createAccount` | Create a GL account |
|
|
184
|
+
| `listJournalEntries` | List journal entries with filtering |
|
|
185
|
+
| `createJournalEntry` | Create a manual journal entry |
|
|
186
|
+
| `getJournalEntry` | Get a journal entry by ID with all lines |
|
|
187
|
+
| `listJournalLines` | List journal lines across all entries |
|
|
188
|
+
| `getBalanceSheet` | Get the balance sheet report |
|
|
189
|
+
| `getIncomeStatement` | Get the income statement (P&L) |
|
|
190
|
+
| `getAccountBalance` | Get balance for a specific GL account |
|
|
191
|
+
| `recogniseRevenue` | Trigger revenue recognition up to a date |
|
|
192
|
+
|
|
193
|
+
### Quotes
|
|
194
|
+
| Tool | Description |
|
|
195
|
+
|---|---|
|
|
196
|
+
| `createQuote` | Create a quote/proposal |
|
|
197
|
+
| `previewQuoteEstimate` | Preview estimated billing for a quote |
|
|
198
|
+
| `getQuoteById` | Get a quote by ID |
|
|
199
|
+
| `acceptQuote` | Accept a quote, converting to a contract |
|
|
200
|
+
|
|
201
|
+
### Custom Attributes and Tax
|
|
202
|
+
| Tool | Description |
|
|
203
|
+
|---|---|
|
|
204
|
+
| `listCustomAttributes` | List custom attribute definitions |
|
|
205
|
+
| `createCustomAttribute` | Create a custom attribute definition |
|
|
206
|
+
| `listTaxCategories` | List tax categories |
|
|
207
|
+
| `createTaxCategory` | Create a tax category |
|
|
208
|
+
|
|
209
|
+
### Jobs
|
|
210
|
+
| Tool | Description |
|
|
211
|
+
|---|---|
|
|
212
|
+
| `listJobs` | List async jobs (invoice gen, rev rec, etc.) |
|
|
213
|
+
| `getJobById` | Get a job by ID to check status |
|
|
214
|
+
|
|
215
|
+
### Business Entities
|
|
216
|
+
| Tool | Description |
|
|
217
|
+
|---|---|
|
|
218
|
+
| `listBusinessEntities` | List business entities |
|
|
219
|
+
| `getBusinessEntityById` | Get a business entity by ID |
|
|
220
|
+
| `createBusinessEntity` | Create a business entity |
|
|
221
|
+
| `updateBusinessEntity` | Update a business entity |
|
|
222
|
+
|
|
223
|
+
### Customer Addresses and Payment Methods
|
|
224
|
+
| Tool | Description |
|
|
225
|
+
|---|---|
|
|
226
|
+
| `listCustomerAddresses` | List addresses for a customer |
|
|
227
|
+
| `createCustomerAddress` | Add an address to a customer |
|
|
228
|
+
| `updateCustomerAddress` | Update a customer address |
|
|
229
|
+
| `listPaymentMethods` | List payment methods for a customer |
|
|
230
|
+
| `attachPaymentMethod` | Attach a payment method to a customer |
|
|
231
|
+
|
|
232
|
+
### Metrics and Usage Events
|
|
233
|
+
| Tool | Description |
|
|
234
|
+
|---|---|
|
|
235
|
+
| `listAggregates` | List billable metrics with filtering |
|
|
236
|
+
| `getAggregateSchemas` | Get all billable metric schemas |
|
|
237
|
+
| `getAggregateEstimates` | Get billable metric estimates |
|
|
238
|
+
| `getAggregateById` | Get a billable metric by ID |
|
|
239
|
+
| `getAggregateLogs` | Get logs for a billable metric |
|
|
240
|
+
| `listRawMetrics` | List usage events with filtering |
|
|
241
|
+
| `createRawMetric` | Create a usage event schema |
|
|
242
|
+
| `getRawMetricById` | Get a usage event by ID |
|
|
243
|
+
| `getRawMetricLogs` | Get logs for a usage event |
|
|
244
|
+
| `getRawMetricBySlug` | Get a usage event by API slug |
|
|
245
|
+
| `ingestRawMetricEvent` | Ingest a usage event |
|
|
246
|
+
|
|
247
|
+
### Other
|
|
248
|
+
| Tool | Description |
|
|
249
|
+
|---|---|
|
|
250
|
+
| `createEntitlement` | Create an entitlement |
|
|
251
|
+
| `getCustomerPortalConfiguration` | Get customer portal config |
|
|
252
|
+
| `getCurrentDateTime` | Get current date/time in multiple formats |
|
|
99
253
|
|
|
100
254
|
## Security
|
|
101
255
|
|
|
102
|
-
- All
|
|
103
|
-
-
|
|
104
|
-
-
|
|
105
|
-
- All authentication is passed through from the client
|
|
256
|
+
- All requests require a valid organization ID and auth token
|
|
257
|
+
- No credentials are stored by the server
|
|
258
|
+
- Auth is passed through from the client
|
|
106
259
|
|
|
107
260
|
## Development
|
|
108
261
|
|
|
109
262
|
```bash
|
|
110
263
|
# Clone the repository
|
|
111
|
-
git clone https://github.com/
|
|
264
|
+
git clone https://github.com/zenskar/mcp-zenskar
|
|
112
265
|
cd mcp-zenskar
|
|
113
266
|
|
|
114
267
|
# Install dependencies
|
|
@@ -145,7 +298,7 @@ Then either point Claude to the globally-installed binary (usually `$(npm bin -g
|
|
|
145
298
|
|
|
146
299
|
## Configuration
|
|
147
300
|
|
|
148
|
-
The server uses `src/mcp-config.json` to define available tools and API endpoints. This file contains the complete mapping of MCP tools to Zenskar API operations.
|
|
301
|
+
The server uses `src/mcp-config.json` to define available tools and API endpoints. This file contains the complete mapping of MCP tools to Zenskar API operations. All tools are declarative — no code changes needed to add new tools.
|
|
149
302
|
|
|
150
303
|
## License
|
|
151
304
|
|
package/package.json
CHANGED
package/src/mcp-config.json
CHANGED
|
@@ -2445,7 +2445,13 @@
|
|
|
2445
2445
|
"required": true,
|
|
2446
2446
|
"position": "body",
|
|
2447
2447
|
"default": "draft",
|
|
2448
|
-
"enum": [
|
|
2448
|
+
"enum": [
|
|
2449
|
+
"draft",
|
|
2450
|
+
"active",
|
|
2451
|
+
"paused",
|
|
2452
|
+
"expired",
|
|
2453
|
+
"disputed"
|
|
2454
|
+
]
|
|
2449
2455
|
},
|
|
2450
2456
|
{
|
|
2451
2457
|
"name": "currency",
|
|
@@ -2490,7 +2496,11 @@
|
|
|
2490
2496
|
"required": false,
|
|
2491
2497
|
"position": "body",
|
|
2492
2498
|
"default": "do_not_renew",
|
|
2493
|
-
"enum": [
|
|
2499
|
+
"enum": [
|
|
2500
|
+
"do_not_renew",
|
|
2501
|
+
"auto_renew",
|
|
2502
|
+
"manual"
|
|
2503
|
+
]
|
|
2494
2504
|
},
|
|
2495
2505
|
{
|
|
2496
2506
|
"name": "bill_parent_customer",
|
|
@@ -2580,7 +2590,13 @@
|
|
|
2580
2590
|
"type": "string",
|
|
2581
2591
|
"required": true,
|
|
2582
2592
|
"position": "body",
|
|
2583
|
-
"enum": [
|
|
2593
|
+
"enum": [
|
|
2594
|
+
"draft",
|
|
2595
|
+
"active",
|
|
2596
|
+
"paused",
|
|
2597
|
+
"expired",
|
|
2598
|
+
"disputed"
|
|
2599
|
+
]
|
|
2584
2600
|
},
|
|
2585
2601
|
{
|
|
2586
2602
|
"name": "currency",
|
|
@@ -2651,7 +2667,11 @@
|
|
|
2651
2667
|
"type": "string",
|
|
2652
2668
|
"required": false,
|
|
2653
2669
|
"position": "body",
|
|
2654
|
-
"enum": [
|
|
2670
|
+
"enum": [
|
|
2671
|
+
"renew_with_default_contract",
|
|
2672
|
+
"renew_with_existing",
|
|
2673
|
+
"do_not_renew"
|
|
2674
|
+
]
|
|
2655
2675
|
},
|
|
2656
2676
|
{
|
|
2657
2677
|
"name": "contract_link",
|
|
@@ -2791,7 +2811,11 @@
|
|
|
2791
2811
|
"type": "string",
|
|
2792
2812
|
"required": false,
|
|
2793
2813
|
"position": "body",
|
|
2794
|
-
"enum": [
|
|
2814
|
+
"enum": [
|
|
2815
|
+
"active",
|
|
2816
|
+
"pause",
|
|
2817
|
+
"trial"
|
|
2818
|
+
]
|
|
2795
2819
|
},
|
|
2796
2820
|
{
|
|
2797
2821
|
"name": "description",
|
|
@@ -3112,7 +3136,12 @@
|
|
|
3112
3136
|
"type": "string",
|
|
3113
3137
|
"required": false,
|
|
3114
3138
|
"position": "query",
|
|
3115
|
-
"enum": [
|
|
3139
|
+
"enum": [
|
|
3140
|
+
"in_progress",
|
|
3141
|
+
"issued",
|
|
3142
|
+
"void",
|
|
3143
|
+
"paid"
|
|
3144
|
+
]
|
|
3116
3145
|
}
|
|
3117
3146
|
],
|
|
3118
3147
|
"requestTemplate": {
|
|
@@ -3157,7 +3186,12 @@
|
|
|
3157
3186
|
"type": "string",
|
|
3158
3187
|
"required": true,
|
|
3159
3188
|
"position": "body",
|
|
3160
|
-
"enum": [
|
|
3189
|
+
"enum": [
|
|
3190
|
+
"in_progress",
|
|
3191
|
+
"issued",
|
|
3192
|
+
"void",
|
|
3193
|
+
"paid"
|
|
3194
|
+
]
|
|
3161
3195
|
},
|
|
3162
3196
|
{
|
|
3163
3197
|
"name": "repayment_method",
|
|
@@ -3165,7 +3199,13 @@
|
|
|
3165
3199
|
"type": "string",
|
|
3166
3200
|
"required": true,
|
|
3167
3201
|
"position": "body",
|
|
3168
|
-
"enum": [
|
|
3202
|
+
"enum": [
|
|
3203
|
+
"credits",
|
|
3204
|
+
"invoice_adjusted",
|
|
3205
|
+
"external_payment",
|
|
3206
|
+
"credits_against_payment",
|
|
3207
|
+
"original_payment_method"
|
|
3208
|
+
]
|
|
3169
3209
|
},
|
|
3170
3210
|
{
|
|
3171
3211
|
"name": "line_items",
|
|
@@ -3247,7 +3287,21 @@
|
|
|
3247
3287
|
"type": "string",
|
|
3248
3288
|
"required": true,
|
|
3249
3289
|
"position": "body",
|
|
3250
|
-
"enum": [
|
|
3290
|
+
"enum": [
|
|
3291
|
+
"card",
|
|
3292
|
+
"cash",
|
|
3293
|
+
"check",
|
|
3294
|
+
"charge_back",
|
|
3295
|
+
"bank_transfer",
|
|
3296
|
+
"direct_debit",
|
|
3297
|
+
"amazon_payments",
|
|
3298
|
+
"paypal_express_checkout",
|
|
3299
|
+
"upi",
|
|
3300
|
+
"netbanking_emandates",
|
|
3301
|
+
"other",
|
|
3302
|
+
"credits",
|
|
3303
|
+
"ach_credit_transfer"
|
|
3304
|
+
]
|
|
3251
3305
|
},
|
|
3252
3306
|
{
|
|
3253
3307
|
"name": "currency_code",
|
|
@@ -3263,7 +3317,13 @@
|
|
|
3263
3317
|
"required": false,
|
|
3264
3318
|
"position": "body",
|
|
3265
3319
|
"default": "payment",
|
|
3266
|
-
"enum": [
|
|
3320
|
+
"enum": [
|
|
3321
|
+
"payment",
|
|
3322
|
+
"refund",
|
|
3323
|
+
"payment_reversal",
|
|
3324
|
+
"authorization",
|
|
3325
|
+
"tax_withheld"
|
|
3326
|
+
]
|
|
3267
3327
|
},
|
|
3268
3328
|
{
|
|
3269
3329
|
"name": "external_id",
|
|
@@ -3825,7 +3885,7 @@
|
|
|
3825
3885
|
"description": "Retrieve a journal entry by its ID, including all journal lines.",
|
|
3826
3886
|
"args": [
|
|
3827
3887
|
{
|
|
3828
|
-
"name": "
|
|
3888
|
+
"name": "journalEntryId",
|
|
3829
3889
|
"description": "The unique identifier of the journal entry.",
|
|
3830
3890
|
"type": "string",
|
|
3831
3891
|
"required": true,
|
|
@@ -3833,7 +3893,7 @@
|
|
|
3833
3893
|
}
|
|
3834
3894
|
],
|
|
3835
3895
|
"requestTemplate": {
|
|
3836
|
-
"url": "/accounting_new/journal_entry/{
|
|
3896
|
+
"url": "/accounting_new/journal_entry/{journalEntryId}",
|
|
3837
3897
|
"method": "GET",
|
|
3838
3898
|
"headers": {
|
|
3839
3899
|
"Content-Type": "application/json"
|
|
@@ -3938,7 +3998,7 @@
|
|
|
3938
3998
|
"description": "Retrieve the balance for a specific accounting account.",
|
|
3939
3999
|
"args": [
|
|
3940
4000
|
{
|
|
3941
|
-
"name": "
|
|
4001
|
+
"name": "accountId",
|
|
3942
4002
|
"description": "The unique identifier of the account.",
|
|
3943
4003
|
"type": "string",
|
|
3944
4004
|
"required": true,
|
|
@@ -3953,7 +4013,7 @@
|
|
|
3953
4013
|
}
|
|
3954
4014
|
],
|
|
3955
4015
|
"requestTemplate": {
|
|
3956
|
-
"url": "/accounting_new/accounts/{
|
|
4016
|
+
"url": "/accounting_new/accounts/{accountId}/balance",
|
|
3957
4017
|
"method": "GET",
|
|
3958
4018
|
"headers": {
|
|
3959
4019
|
"Content-Type": "application/json"
|
|
@@ -4033,7 +4093,7 @@
|
|
|
4033
4093
|
"description": "Update an existing product's details.",
|
|
4034
4094
|
"args": [
|
|
4035
4095
|
{
|
|
4036
|
-
"name": "
|
|
4096
|
+
"name": "productId",
|
|
4037
4097
|
"description": "The unique identifier of the product to update.",
|
|
4038
4098
|
"type": "string",
|
|
4039
4099
|
"required": true,
|
|
@@ -4083,7 +4143,7 @@
|
|
|
4083
4143
|
}
|
|
4084
4144
|
],
|
|
4085
4145
|
"requestTemplate": {
|
|
4086
|
-
"url": "/products/{
|
|
4146
|
+
"url": "/products/{productId}",
|
|
4087
4147
|
"method": "PATCH",
|
|
4088
4148
|
"headers": {
|
|
4089
4149
|
"Content-Type": "application/json"
|
|
@@ -4098,7 +4158,7 @@
|
|
|
4098
4158
|
"description": "Retrieve all pricing configurations for a specific product.",
|
|
4099
4159
|
"args": [
|
|
4100
4160
|
{
|
|
4101
|
-
"name": "
|
|
4161
|
+
"name": "productId",
|
|
4102
4162
|
"description": "The unique identifier of the product.",
|
|
4103
4163
|
"type": "string",
|
|
4104
4164
|
"required": true,
|
|
@@ -4106,7 +4166,7 @@
|
|
|
4106
4166
|
}
|
|
4107
4167
|
],
|
|
4108
4168
|
"requestTemplate": {
|
|
4109
|
-
"url": "/products/{
|
|
4169
|
+
"url": "/products/{productId}/pricing",
|
|
4110
4170
|
"method": "GET",
|
|
4111
4171
|
"headers": {
|
|
4112
4172
|
"Content-Type": "application/json"
|
|
@@ -4121,7 +4181,7 @@
|
|
|
4121
4181
|
"description": "Create a new pricing configuration for a product.",
|
|
4122
4182
|
"args": [
|
|
4123
4183
|
{
|
|
4124
|
-
"name": "
|
|
4184
|
+
"name": "productId",
|
|
4125
4185
|
"description": "The unique identifier of the product.",
|
|
4126
4186
|
"type": "string",
|
|
4127
4187
|
"required": true,
|
|
@@ -4171,7 +4231,7 @@
|
|
|
4171
4231
|
}
|
|
4172
4232
|
],
|
|
4173
4233
|
"requestTemplate": {
|
|
4174
|
-
"url": "/products/{
|
|
4234
|
+
"url": "/products/{productId}/pricing",
|
|
4175
4235
|
"method": "POST",
|
|
4176
4236
|
"headers": {
|
|
4177
4237
|
"Content-Type": "application/json"
|
|
@@ -4223,7 +4283,7 @@
|
|
|
4223
4283
|
"description": "Retrieve a plan by its ID, including phases, products, and pricing configurations.",
|
|
4224
4284
|
"args": [
|
|
4225
4285
|
{
|
|
4226
|
-
"name": "
|
|
4286
|
+
"name": "planId",
|
|
4227
4287
|
"description": "The unique identifier of the plan.",
|
|
4228
4288
|
"type": "string",
|
|
4229
4289
|
"required": true,
|
|
@@ -4231,7 +4291,7 @@
|
|
|
4231
4291
|
}
|
|
4232
4292
|
],
|
|
4233
4293
|
"requestTemplate": {
|
|
4234
|
-
"url": "/templates/plan/{
|
|
4294
|
+
"url": "/templates/plan/{planId}",
|
|
4235
4295
|
"method": "GET",
|
|
4236
4296
|
"headers": {
|
|
4237
4297
|
"Content-Type": "application/json"
|
|
@@ -4297,7 +4357,7 @@
|
|
|
4297
4357
|
"description": "Add products with pricing to an existing plan.",
|
|
4298
4358
|
"args": [
|
|
4299
4359
|
{
|
|
4300
|
-
"name": "
|
|
4360
|
+
"name": "planId",
|
|
4301
4361
|
"description": "The unique identifier of the plan.",
|
|
4302
4362
|
"type": "string",
|
|
4303
4363
|
"required": true,
|
|
@@ -4312,7 +4372,7 @@
|
|
|
4312
4372
|
}
|
|
4313
4373
|
],
|
|
4314
4374
|
"requestTemplate": {
|
|
4315
|
-
"url": "/templates/plan/{
|
|
4375
|
+
"url": "/templates/plan/{planId}/products",
|
|
4316
4376
|
"method": "POST",
|
|
4317
4377
|
"headers": {
|
|
4318
4378
|
"Content-Type": "application/json"
|
|
@@ -4327,7 +4387,7 @@
|
|
|
4327
4387
|
"description": "Preview the estimated billing for a plan, showing projected charges per phase.",
|
|
4328
4388
|
"args": [
|
|
4329
4389
|
{
|
|
4330
|
-
"name": "
|
|
4390
|
+
"name": "planId",
|
|
4331
4391
|
"description": "The unique identifier of the plan.",
|
|
4332
4392
|
"type": "string",
|
|
4333
4393
|
"required": true,
|
|
@@ -4349,7 +4409,7 @@
|
|
|
4349
4409
|
}
|
|
4350
4410
|
],
|
|
4351
4411
|
"requestTemplate": {
|
|
4352
|
-
"url": "/templates/plan/{
|
|
4412
|
+
"url": "/templates/plan/{planId}/preview",
|
|
4353
4413
|
"method": "POST",
|
|
4354
4414
|
"headers": {
|
|
4355
4415
|
"Content-Type": "application/json"
|
|
@@ -4641,7 +4701,7 @@
|
|
|
4641
4701
|
"description": "Retrieve a quote by its ID, including phases, pricing, and status.",
|
|
4642
4702
|
"args": [
|
|
4643
4703
|
{
|
|
4644
|
-
"name": "
|
|
4704
|
+
"name": "quoteId",
|
|
4645
4705
|
"description": "The unique identifier of the quote.",
|
|
4646
4706
|
"type": "string",
|
|
4647
4707
|
"required": true,
|
|
@@ -4649,7 +4709,7 @@
|
|
|
4649
4709
|
}
|
|
4650
4710
|
],
|
|
4651
4711
|
"requestTemplate": {
|
|
4652
|
-
"url": "/quotes/{
|
|
4712
|
+
"url": "/quotes/{quoteId}",
|
|
4653
4713
|
"method": "GET",
|
|
4654
4714
|
"headers": {
|
|
4655
4715
|
"Content-Type": "application/json"
|
|
@@ -4664,7 +4724,7 @@
|
|
|
4664
4724
|
"description": "Accept a quote, converting it into an active contract.",
|
|
4665
4725
|
"args": [
|
|
4666
4726
|
{
|
|
4667
|
-
"name": "
|
|
4727
|
+
"name": "quoteId",
|
|
4668
4728
|
"description": "The unique identifier of the quote to accept.",
|
|
4669
4729
|
"type": "string",
|
|
4670
4730
|
"required": true,
|
|
@@ -4672,7 +4732,7 @@
|
|
|
4672
4732
|
}
|
|
4673
4733
|
],
|
|
4674
4734
|
"requestTemplate": {
|
|
4675
|
-
"url": "/quotes/{
|
|
4735
|
+
"url": "/quotes/{quoteId}/accept",
|
|
4676
4736
|
"method": "POST",
|
|
4677
4737
|
"headers": {
|
|
4678
4738
|
"Content-Type": "application/json"
|
|
@@ -4724,7 +4784,7 @@
|
|
|
4724
4784
|
"description": "Retrieve a specific job by its ID to check status and results.",
|
|
4725
4785
|
"args": [
|
|
4726
4786
|
{
|
|
4727
|
-
"name": "
|
|
4787
|
+
"name": "jobId",
|
|
4728
4788
|
"description": "The unique identifier of the job.",
|
|
4729
4789
|
"type": "string",
|
|
4730
4790
|
"required": true,
|
|
@@ -4732,7 +4792,7 @@
|
|
|
4732
4792
|
}
|
|
4733
4793
|
],
|
|
4734
4794
|
"requestTemplate": {
|
|
4735
|
-
"url": "/jobs/{
|
|
4795
|
+
"url": "/jobs/{jobId}",
|
|
4736
4796
|
"method": "GET",
|
|
4737
4797
|
"headers": {
|
|
4738
4798
|
"Content-Type": "application/json"
|
|
@@ -4812,7 +4872,7 @@
|
|
|
4812
4872
|
"description": "Update an existing contact's details.",
|
|
4813
4873
|
"args": [
|
|
4814
4874
|
{
|
|
4815
|
-
"name": "
|
|
4875
|
+
"name": "contactId",
|
|
4816
4876
|
"description": "The unique identifier of the contact to update.",
|
|
4817
4877
|
"type": "string",
|
|
4818
4878
|
"required": true,
|
|
@@ -4862,7 +4922,7 @@
|
|
|
4862
4922
|
}
|
|
4863
4923
|
],
|
|
4864
4924
|
"requestTemplate": {
|
|
4865
|
-
"url": "/contacts/{
|
|
4925
|
+
"url": "/contacts/{contactId}",
|
|
4866
4926
|
"method": "PATCH",
|
|
4867
4927
|
"headers": {
|
|
4868
4928
|
"Content-Type": "application/json"
|
|
@@ -4907,7 +4967,7 @@
|
|
|
4907
4967
|
"description": "Retrieve a business entity by its ID.",
|
|
4908
4968
|
"args": [
|
|
4909
4969
|
{
|
|
4910
|
-
"name": "
|
|
4970
|
+
"name": "entityId",
|
|
4911
4971
|
"description": "The unique identifier of the business entity.",
|
|
4912
4972
|
"type": "string",
|
|
4913
4973
|
"required": true,
|
|
@@ -4915,7 +4975,7 @@
|
|
|
4915
4975
|
}
|
|
4916
4976
|
],
|
|
4917
4977
|
"requestTemplate": {
|
|
4918
|
-
"url": "/business_entities/{
|
|
4978
|
+
"url": "/business_entities/{entityId}",
|
|
4919
4979
|
"method": "GET",
|
|
4920
4980
|
"headers": {
|
|
4921
4981
|
"Content-Type": "application/json"
|
|
@@ -4930,7 +4990,7 @@
|
|
|
4930
4990
|
"description": "Update an existing business entity's details.",
|
|
4931
4991
|
"args": [
|
|
4932
4992
|
{
|
|
4933
|
-
"name": "
|
|
4993
|
+
"name": "entityId",
|
|
4934
4994
|
"description": "The unique identifier of the business entity to update.",
|
|
4935
4995
|
"type": "string",
|
|
4936
4996
|
"required": true,
|
|
@@ -4966,7 +5026,7 @@
|
|
|
4966
5026
|
}
|
|
4967
5027
|
],
|
|
4968
5028
|
"requestTemplate": {
|
|
4969
|
-
"url": "/business_entities/{
|
|
5029
|
+
"url": "/business_entities/{entityId}",
|
|
4970
5030
|
"method": "PATCH",
|
|
4971
5031
|
"headers": {
|
|
4972
5032
|
"Content-Type": "application/json"
|
|
@@ -4981,7 +5041,7 @@
|
|
|
4981
5041
|
"description": "Retrieve all addresses for a specific customer.",
|
|
4982
5042
|
"args": [
|
|
4983
5043
|
{
|
|
4984
|
-
"name": "
|
|
5044
|
+
"name": "customerId",
|
|
4985
5045
|
"description": "The unique identifier of the customer.",
|
|
4986
5046
|
"type": "string",
|
|
4987
5047
|
"required": true,
|
|
@@ -4989,7 +5049,7 @@
|
|
|
4989
5049
|
}
|
|
4990
5050
|
],
|
|
4991
5051
|
"requestTemplate": {
|
|
4992
|
-
"url": "/customers/{
|
|
5052
|
+
"url": "/customers/{customerId}/addresses",
|
|
4993
5053
|
"method": "GET",
|
|
4994
5054
|
"headers": {
|
|
4995
5055
|
"Content-Type": "application/json"
|
|
@@ -5004,7 +5064,7 @@
|
|
|
5004
5064
|
"description": "Add a new address to a customer.",
|
|
5005
5065
|
"args": [
|
|
5006
5066
|
{
|
|
5007
|
-
"name": "
|
|
5067
|
+
"name": "customerId",
|
|
5008
5068
|
"description": "The unique identifier of the customer.",
|
|
5009
5069
|
"type": "string",
|
|
5010
5070
|
"required": true,
|
|
@@ -5068,7 +5128,7 @@
|
|
|
5068
5128
|
}
|
|
5069
5129
|
],
|
|
5070
5130
|
"requestTemplate": {
|
|
5071
|
-
"url": "/customers/{
|
|
5131
|
+
"url": "/customers/{customerId}/addresses",
|
|
5072
5132
|
"method": "POST",
|
|
5073
5133
|
"headers": {
|
|
5074
5134
|
"Content-Type": "application/json"
|
|
@@ -5083,14 +5143,14 @@
|
|
|
5083
5143
|
"description": "Update an existing customer address.",
|
|
5084
5144
|
"args": [
|
|
5085
5145
|
{
|
|
5086
|
-
"name": "
|
|
5146
|
+
"name": "customerId",
|
|
5087
5147
|
"description": "The unique identifier of the customer.",
|
|
5088
5148
|
"type": "string",
|
|
5089
5149
|
"required": true,
|
|
5090
5150
|
"position": "path"
|
|
5091
5151
|
},
|
|
5092
5152
|
{
|
|
5093
|
-
"name": "
|
|
5153
|
+
"name": "addressId",
|
|
5094
5154
|
"description": "The unique identifier of the address to update.",
|
|
5095
5155
|
"type": "string",
|
|
5096
5156
|
"required": true,
|
|
@@ -5147,7 +5207,7 @@
|
|
|
5147
5207
|
}
|
|
5148
5208
|
],
|
|
5149
5209
|
"requestTemplate": {
|
|
5150
|
-
"url": "/customers/{
|
|
5210
|
+
"url": "/customers/{customerId}/addresses/{addressId}",
|
|
5151
5211
|
"method": "PATCH",
|
|
5152
5212
|
"headers": {
|
|
5153
5213
|
"Content-Type": "application/json"
|
|
@@ -5162,7 +5222,7 @@
|
|
|
5162
5222
|
"description": "Retrieve all payment methods for a specific customer.",
|
|
5163
5223
|
"args": [
|
|
5164
5224
|
{
|
|
5165
|
-
"name": "
|
|
5225
|
+
"name": "customerId",
|
|
5166
5226
|
"description": "The unique identifier of the customer.",
|
|
5167
5227
|
"type": "string",
|
|
5168
5228
|
"required": true,
|
|
@@ -5170,7 +5230,7 @@
|
|
|
5170
5230
|
}
|
|
5171
5231
|
],
|
|
5172
5232
|
"requestTemplate": {
|
|
5173
|
-
"url": "/customers/{
|
|
5233
|
+
"url": "/customers/{customerId}/payment_methods",
|
|
5174
5234
|
"method": "GET",
|
|
5175
5235
|
"headers": {
|
|
5176
5236
|
"Content-Type": "application/json"
|
|
@@ -5185,7 +5245,7 @@
|
|
|
5185
5245
|
"description": "Attach a payment method to a customer.",
|
|
5186
5246
|
"args": [
|
|
5187
5247
|
{
|
|
5188
|
-
"name": "
|
|
5248
|
+
"name": "customerId",
|
|
5189
5249
|
"description": "The unique identifier of the customer.",
|
|
5190
5250
|
"type": "string",
|
|
5191
5251
|
"required": true,
|
|
@@ -5214,7 +5274,7 @@
|
|
|
5214
5274
|
}
|
|
5215
5275
|
],
|
|
5216
5276
|
"requestTemplate": {
|
|
5217
|
-
"url": "/customers/{
|
|
5277
|
+
"url": "/customers/{customerId}/payment_methods/attach",
|
|
5218
5278
|
"method": "POST",
|
|
5219
5279
|
"headers": {
|
|
5220
5280
|
"Content-Type": "application/json"
|