feat(manifest): add externalNumber reference to quote/order/delivery

- Add `external_number NVARCHAR(100)` column to the `manifest` table.
- Thread `externalNumber` through manifestDoc and delivery SQL (list,
  header, create, update).
- Include `externalNumber` in shapeSummary and quote/order/delivery
  create/update/list/getById handlers (optional, clearable on update).
- Update README type definitions and regenerate API/schema docs.
This commit is contained in:
seb
2026-08-08 09:13:20 +02:00
parent f302cda39e
commit 29099b2a16
23 changed files with 210 additions and 143 deletions

View File

@@ -17,11 +17,12 @@ Creates a new order for the user's selected company with its lines.
| `body.number` | `string` | The order number. |
| `body.date` | `string` | The order date. |
| `[body.entityId]` | `number` | The id of the customer entity. |
| `[body.externalNumber]` | `string` | An external (customer) reference number. |
| `[body.lines]` | `Array<object>` | The order lines. |
**Returns**
`Promise<{id: number, number: string, type: string, entityId: number|null, date: string, lines: Array<object>}>` — The created order.
`Promise<{id: number, number: string, type: string, entityId: number|null, externalNumber: string|null, date: string, lines: Array<object>}>` — The created order.
**Throws**
@@ -31,7 +32,7 @@ Creates a new order for the user's selected company with its lines.
```js
const order = await store.order.create(42, { number: 'B-2026-001', date: '2026-09-15', entityId: 12, lines: [...] });
// => { id, number, type, entityId, date, lines: [...] }
// => { id, number, type, entityId, externalNumber, date, lines: [...] }
```
## `order.delete`
@@ -76,7 +77,7 @@ Returns a single order by its id within the user's selected company.
**Returns**
`Promise<{id: number, number: string, type: string, entityId: number|null, date: string, lines: Array<object>}>` — The order with its lines.
`Promise<{id: number, number: string, type: string, entityId: number|null, externalNumber: string|null, date: string, lines: Array<object>}>` — The order with its lines.
**Throws**
@@ -86,7 +87,7 @@ Returns a single order by its id within the user's selected company.
```js
const order = await store.order.getById(42, 5);
// => { id, number, type, entityId, date, lines: [...] }
// => { id, number, type, entityId, externalNumber, date, lines: [...] }
```
## `order.list`
@@ -103,13 +104,13 @@ Lists the orders of the user's selected company.
**Returns**
`Promise<Array<{id: number, number: string, type: string, entityId: number|null, date: string}>>` — The orders.
`Promise<Array<{id: number, number: string, type: string, entityId: number|null, externalNumber: string|null, date: string}>>` — The orders.
**Example**
```js
const orders = await store.order.list(42);
// => [{ id, number, type, entityId, date }]
// => [{ id, number, type, entityId, externalNumber, date }]
```
## `order.update`
@@ -128,11 +129,12 @@ Updates an order's header and/or lines.
| `[patch.number]` | `string` | The new order number. |
| `[patch.date]` | `string` | The new order date. |
| `[patch.entityId]` | `number` | The new customer entity id. |
| `[patch.externalNumber]` | `string` | The new external (customer) reference number. |
| `[patch.lines]` | `Array<object>` | The new order lines. |
**Returns**
`Promise<{id: number, number: string, type: string, entityId: number|null, date: string, lines: Array<object>}>` — The updated order.
`Promise<{id: number, number: string, type: string, entityId: number|null, externalNumber: string|null, date: string, lines: Array<object>}>` — The updated order.
**Throws**