Skip to content

Commit c867b18

Browse files
authored
Merge pull request #9 from 29next/restrcture
Restrcture
2 parents 06b0d19 + d95c6f5 commit c867b18

93 files changed

Lines changed: 623 additions & 1492 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

_snippets/_moving-fulfillment-orders.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,16 +11,16 @@ stateDiagram-v2
1111
availableLocations --> moveItems
1212
```
1313
Moving fulfillment order items is a 2-step process:
14-
1. Retrieve available locations for items to move using the [availableLocationsRetrieve](/docs/api/admin/reference/#/operations/availableLocationsRetrieve) endpoint.
15-
2. Move fulfilllment order line items to a new location using the [fulfillmentOrdersMove](/docs/api/admin/reference/#/operations/fulfillmentOrdersMove) endpoint.
14+
1. Retrieve available locations for items to move using the [availableLocationsRetrieve](/docs/admin-api/reference/#/operations/availableLocationsRetrieve) endpoint.
15+
2. Move fulfilllment order line items to a new location using the [fulfillmentOrdersMove](/docs/admin-api/reference/#/operations/fulfillmentOrdersMove) endpoint.
1616

1717
:::info
18-
Fulfillment Orders must be `"status": "open"` to be moved to a new location. If the fulfillment order you want to move is `"status": "processing"`, use the [cancellationRequestSend](/docs/api/admin/reference/#/operations/cancellationRequestSend) endpoint to request cancellation with the current fulfillment location before moving to a new location.
18+
Fulfillment Orders must be `"status": "open"` to be moved to a new location. If the fulfillment order you want to move is `"status": "processing"`, use the [cancellationRequestSend](/docs/admin-api/reference/#/operations/cancellationRequestSend) endpoint to request cancellation with the current fulfillment location before moving to a new location.
1919
:::
2020

2121
#### Retrieve Available Locations
2222

23-
Fulfillment order line items often contain products that are in stock at many locations where they could be fulfilled from. To check what locations fulfillment order items are available at, use the [availableLocationsRetrieve](/docs/api/admin/reference/#/operations/availableLocationsRetrieve) endpoint.
23+
Fulfillment order line items often contain products that are in stock at many locations where they could be fulfilled from. To check what locations fulfillment order items are available at, use the [availableLocationsRetrieve](/docs/admin-api/reference/#/operations/availableLocationsRetrieve) endpoint.
2424

2525
```json title="Retrieve Available Fulfillment Locations"
2626
// GET https://{store}.29next.store/api/admin/fulfillment-orders/{id}/available-locations/
@@ -48,7 +48,7 @@ Fulfillment order line items often contain products that are in stock at many lo
4848

4949
#### Move a Fulfillment Order
5050

51-
Once the available locations fulfillment order line items can move, use the [fulfillmentOrdersMove](/docs/api/admin/reference/#/operations/fulfillmentOrdersMove) endpoint to move all or some of the line items.
51+
Once the available locations fulfillment order line items can move, use the [fulfillmentOrdersMove](/docs/admin-api/reference/#/operations/fulfillmentOrdersMove) endpoint to move all or some of the line items.
5252

5353
```json title="Move Fulfillment Order Items to New Location"
5454
// POST https://{store}.29next.store/api/admin/fulfillment-orders/{id}/move/

agents.md

Lines changed: 29 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -101,7 +101,7 @@ The Admin API supports a complete order creation flow with payment processing, e
101101
- **Auth:** Campaign API key
102102
- **Capabilities:** Cart creation, order creation, upsell creation, order retrieval, session tracking, shipping options
103103
- **OpenAPI spec:** `static/api/campaigns/v1.yaml`
104-
- **Docs:** `docs/api/campaigns.md`
104+
- **Docs:** `docs/campaigns/api.md`
105105

106106
### Admin API
107107
- **Type:** REST
@@ -113,7 +113,7 @@ The Admin API supports a complete order creation flow with payment processing, e
113113
- `unstable` — development
114114
- **Capabilities:** Full CRUD on all store resources (orders, products, customers, subscriptions, fulfillments, gateways, webhooks, etc.)
115115
- **OpenAPI specs:** `static/api/admin/2023-02-10.yaml`, `static/api/admin/2024-04-01.yaml`, `static/api/admin/unstable.yaml`
116-
- **Docs:** `docs/api/admin/` (overview, permissions, 15 feature guides)
116+
- **Docs:** `docs/admin-api/` (overview, permissions, 15 feature guides)
117117

118118
**Admin API guides focus areas:**
119119
- Payment methods: Apple Pay, Google Pay, PayPal, Klarna, Bancontact, iDEAL, SEPA Debit, TWINT, 3DS2
@@ -162,14 +162,10 @@ Apps extend platform functionality by combining Admin API, Webhooks, and Storefr
162162
```
163163
docs/
164164
├── index.md → Getting Started landing page
165-
├── api/
166-
│ ├── index.md → APIs overview
167-
│ ├── campaigns.md → Campaigns API overview + endpoints
168-
│ ├── checkout-links.md → Checkout Links feature
169-
│ └── admin/
170-
│ ├── index.md → Admin API overview + auth
171-
│ ├── permissions.md → OAuth permission scopes
172-
│ └── guides/ → 15 feature guides (payments, orders, subscriptions)
165+
├── admin-api/
166+
│ ├── index.md → Admin API overview + auth
167+
│ ├── permissions.md → OAuth permission scopes
168+
│ └── guides/ → 15 feature guides (payments, orders, subscriptions)
173169
├── apps/
174170
│ ├── index.md → Apps overview
175171
│ ├── app-kit.md → App development framework
@@ -183,15 +179,16 @@ docs/
183179
│ ├── oauth/ → OAuth flows (4 files)
184180
│ └── guides/ → App pattern guides (4 files)
185181
├── campaigns/
186-
│ └── index.md → Campaign concepts + getting started
187-
├── campaign-cart/ → Campaign Cart SDK (largest section, ~48 files)
188-
│ ├── index.md → Quick start + configuration
189-
│ ├── data-attributes/ → HTML attribute reference (8 files)
190-
│ ├── javascript-api/ → JS API reference (5 files)
191-
│ ├── analytics/ → Analytics integrations (9+ files)
192-
│ ├── guides/ → Implementation guides
193-
│ ├── utilities/ → FOMO, exit intent, loading, debugger
194-
│ └── upsells/ → Post-purchase upsell flows
182+
│ ├── index.md → Campaign concepts + getting started
183+
│ ├── api.md → Campaigns API overview + endpoints
184+
│ └── campaign-cart/ → Campaign Cart SDK (largest section, ~48 files)
185+
│ ├── index.md → Quick start + configuration
186+
│ ├── data-attributes/ → HTML attribute reference (8 files)
187+
│ ├── javascript-api/ → JS API reference (5 files)
188+
│ ├── analytics/ → Analytics integrations (9+ files)
189+
│ ├── guides/ → Implementation guides
190+
│ ├── utilities/ → FOMO, exit intent, loading, debugger
191+
│ └── upsells/ → Post-purchase upsell flows
195192
├── storefront/
196193
│ ├── index.md → Storefront overview
197194
│ ├── api.md → Storefront GraphQL API
@@ -219,6 +216,17 @@ static/api/
219216

220217
## Documentation Conventions
221218

219+
### Navbar (Left)
220+
221+
| Label | Path |
222+
|-------|------|
223+
| Getting Started | `/docs/` |
224+
| Campaigns | `/docs/campaigns/` |
225+
| Storefront | `/docs/storefront/` |
226+
| Apps | `/docs/apps/` |
227+
| Admin API | `/docs/admin-api/` |
228+
| Webhooks | `/docs/webhooks/` |
229+
222230
### Tooling
223231
- **Docusaurus** with MDX support
224232
- **Stoplight Elements** for rendering OpenAPI specs inline
@@ -233,15 +241,15 @@ static/api/
233241
- **Code examples:** JavaScript, Python, cURL — fenced with language + optional `title="..."`
234242
- **Tables:** Markdown tables for comparisons, event lists, attribute references
235243
- **Cross-links:** Relative markdown links (`[text](/docs/path/to/file.md)`)
236-
- **API references:** Link to Stoplight-rendered specs (`/docs/api/admin/reference/#/...`)
244+
- **API references:** Link to Stoplight-rendered specs (`/docs/admin-api/reference/#/...`)
237245
- **MDX components:** `DocCardList`, `IntroCards` for auto-generated navigation cards
238246

239247
### URL Structure
240248
All published docs follow: `https://developers.29next.com/docs/{section}/{path}`
241249

242250
Key redirects configured in `docusaurus.config.js`:
243251
- `/api/``/docs/api`
244-
- `/api/admin``/docs/api/admin/`
252+
- `/docs/admin-api``/docs/admin-api/`
245253
- `/themes``/docs/storefront/themes`
246254
- `/webhooks``/docs/webhooks`
247255

File renamed without changes.
File renamed without changes.
File renamed without changes.

docs/api/admin/guides/external-checkout.md renamed to docs/admin-api/guides/external-checkout.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -58,11 +58,11 @@ Carts are the starting point for all orders, carts are essentially draft orders
5858
:::info Notes
5959
- The carts create API accepts a user object that will `get or create` the user by their email address making it is safe to use for both new and existing users.
6060
- Attribution added to a cart is carried over to the Orders and Subscriptions created on the users next order, you do not need to pass this data on the order request.
61-
- If you need to capture an address with the cart, use the [usersAddressesCreate](/docs/api/admin/reference/#/operations/usersAddressesCreate) endpoint which will create a default address for the user.
61+
- If you need to capture an address with the cart, use the [usersAddressesCreate](/docs/admin-api/reference/#/operations/usersAddressesCreate) endpoint which will create a default address for the user.
6262
:::
6363

6464
### Create Order
65-
Creating an order is the core resource in an external checkout flow, see the example below to familiarize yourself with the [ordersCreate](/docs/api/admin/reference/#/operations/ordersCreate) API endpoint.
65+
Creating an order is the core resource in an external checkout flow, see the example below to familiarize yourself with the [ordersCreate](/docs/admin-api/reference/#/operations/ordersCreate) API endpoint.
6666

6767
```json title="Request"
6868
// POST https://{store}.29next.store/api/admin/orders/
@@ -103,12 +103,12 @@ Creating an order is the core resource in an external checkout flow, see the exa
103103
- Attribution detail are not necessary if you have already added it to the users active cart.
104104
- `shipping_code` and `shipping_price` are optional parameters you can set to specify the shipping method and shipping price.
105105
- If you already created an address for the user, pass `use_default_shipping_address` and `use_default_billing_address` as true to use their default address for the order.
106-
- For additional payment methods, see our guides on [Card Tokenization](/docs/api/admin/guides/iframe-payment-form.md), [3DS2](/docs/api/admin/guides/3ds2.md), [Apple Pay](/docs/api/admin/guides/apple-pay.md), [PayPal](/docs/api/admin/guides/paypal.md), [Klarna](/docs/api/admin/guides/klarna.md), [Twint](/docs/api/admin/guides/twint.md), [Bancontact](/docs/api/admin/guides/bancontact.md), and [SEPA](/docs/api/admin/guides/sepa-debit.md).
106+
- For additional payment methods, see our guides on [Card Tokenization](/docs/admin-api/guides/iframe-payment-form.md), [3DS2](/docs/admin-api/guides/3ds2.md), [Apple Pay](/docs/admin-api/guides/apple-pay.md), [PayPal](/docs/admin-api/guides/paypal.md), [Klarna](/docs/admin-api/guides/klarna.md), [Twint](/docs/admin-api/guides/twint.md), [Bancontact](/docs/admin-api/guides/bancontact.md), and [SEPA](/docs/admin-api/guides/sepa-debit.md).
107107
:::
108108

109109
### Add Upsells
110110

111-
Add additional products (line items) to the original order through the [ordersAddLineItemsCreate](/docs/api/admin/reference/#/operations/ordersAddLineItemsCreate) API. Adding items to the order will automatically re-use the order's initial payment method to collect payment for the additional products.
111+
Add additional products (line items) to the original order through the [ordersAddLineItemsCreate](/docs/admin-api/reference/#/operations/ordersAddLineItemsCreate) API. Adding items to the order will automatically re-use the order's initial payment method to collect payment for the additional products.
112112

113113
``` json title="Request"
114114
// POST https://{store}.29next.store/api/admin/orders/<NUMBER>/add-line-items/
@@ -220,7 +220,7 @@ Cart and Order `attribution` object sets the [marketing attribution](https://doc
220220
The `shipping_code` is an optional field to specify the Shipping Method to be used for the order, **if not passed, the cheapest Shipping Method will be used**. `shipping_price` is also optional and provides a way to override the configured price for the Shipping Method of the order allowing you to discount or charge an upsell for shipping on the order.
221221

222222
### Order Addresses Detail
223-
The `shipping_address` object on the order represents the address where the order will be shipped, and similarly for the `billing_address`. The first `shipping_address` and `billing_address` created for a user is automatically set as their default shipping and billing address, [see API Reference](/docs/api/admin/reference/#/operations/orders_create).
223+
The `shipping_address` object on the order represents the address where the order will be shipped, and similarly for the `billing_address`. The first `shipping_address` and `billing_address` created for a user is automatically set as their default shipping and billing address, [see API Reference](/docs/admin-api/reference/#/operations/orders_create).
224224

225225
:::tip
226226
Use `billing_same_as_shipping_address` to forego having to pass a full duplicate address for `billing_address`.
@@ -249,7 +249,7 @@ Use `billing_same_as_shipping_address` to forego having to pass a full duplicate
249249

250250
The order `payment_method` and `payment_details` objects work in tandem to specify the payment method for the order and provide any additional data that may be required per payment method.
251251

252-
The example below uses a [Test Card Token](/docs/api/admin/guides/testing-guide.md#test-card-tokens) to create a **Test Order**.
252+
The example below uses a [Test Card Token](/docs/admin-api/guides/testing-guide.md#test-card-tokens) to create a **Test Order**.
253253

254254

255255
```json
@@ -272,14 +272,14 @@ See payment method specific guides on creating orders below.
272272

273273
| Payment Method | Flow | Express | Upsells | Subscriptions |
274274
| --- | --- | --- | --- | --- |
275-
| [`card_token`](/docs/api/admin/guides/iframe-payment-form.md) | Direct & Redirect ([3DS](/docs/api/admin/guides/3ds2.md)) | Yes | Yes | Yes |
276-
| [`apple_pay`](/docs/api/admin/guides/apple-pay.md) | Redirect | Yes | Yes | Yes |
277-
| [`google_pay`](/docs/api/admin/guides/google-pay.md) | Redirect | Yes | Yes | Yes |
278-
| [`paypal`](/docs/api/admin/guides/paypal.md) | Redirect | Yes | Yes | Yes |
279-
| [`klarna`](/docs/api/admin/guides/klarna.md) | Redirect | No | Yes | Yes |
280-
| [`twint`](/docs/api/admin/guides/twint.md) | Redirect | No | Yes | Yes |
281-
| [`bancontact`](/docs/api/admin/guides/bancontact.md) | Redirect | No | No | No |
282-
| [`ideal`](/docs/api/admin/guides/ideal.md) | Redirect | No | No | No |
283-
| [`sepa_direct`](/docs/api/admin/guides/sepa-debit.md) | Redirect | No | No | No |
275+
| [`card_token`](/docs/admin-api/guides/iframe-payment-form.md) | Direct & Redirect ([3DS](/docs/admin-api/guides/3ds2.md)) | Yes | Yes | Yes |
276+
| [`apple_pay`](/docs/admin-api/guides/apple-pay.md) | Redirect | Yes | Yes | Yes |
277+
| [`google_pay`](/docs/admin-api/guides/google-pay.md) | Redirect | Yes | Yes | Yes |
278+
| [`paypal`](/docs/admin-api/guides/paypal.md) | Redirect | Yes | Yes | Yes |
279+
| [`klarna`](/docs/admin-api/guides/klarna.md) | Redirect | No | Yes | Yes |
280+
| [`twint`](/docs/admin-api/guides/twint.md) | Redirect | No | Yes | Yes |
281+
| [`bancontact`](/docs/admin-api/guides/bancontact.md) | Redirect | No | No | No |
282+
| [`ideal`](/docs/admin-api/guides/ideal.md) | Redirect | No | No | No |
283+
| [`sepa_direct`](/docs/admin-api/guides/sepa-debit.md) | Redirect | No | No | No |
284284

285285

File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)