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:
@@ -17,11 +17,12 @@ Creates a new delivery for the user's selected company with its lines.
|
||||
| `body.number` | `string` | The delivery number. |
|
||||
| `body.date` | `string` | The delivery date. |
|
||||
| `body.supplierId` | `number` | The id of the supplier. |
|
||||
| `[body.externalNumber]` | `string` | An external (supplier) reference number. |
|
||||
| `[body.lines]` | `Array<object>` | The delivery lines. |
|
||||
|
||||
**Returns**
|
||||
|
||||
`Promise<{id: number, number: string, type: string, entityId: number, date: string, lines: Array<object>}>` — The created delivery.
|
||||
`Promise<{id: number, number: string, type: string, entityId: number, externalNumber: string|null, date: string, lines: Array<object>}>` — The created delivery.
|
||||
|
||||
**Throws**
|
||||
|
||||
@@ -31,7 +32,7 @@ Creates a new delivery for the user's selected company with its lines.
|
||||
|
||||
```js
|
||||
const delivery = await store.delivery.create(42, { number: 'D-1', date: '2026-01-01', supplierId: 5, lines: [...] });
|
||||
// => { id, number, type, entityId, date, lines: [...] }
|
||||
// => { id, number, type, entityId, externalNumber, date, lines: [...] }
|
||||
```
|
||||
|
||||
## `delivery.delete`
|
||||
@@ -76,7 +77,7 @@ Returns a single delivery by its id within the user's selected company.
|
||||
|
||||
**Returns**
|
||||
|
||||
`Promise<{id: number, number: string, type: string, entityId: number, date: string, lines: Array<object>}>` — The delivery.
|
||||
`Promise<{id: number, number: string, type: string, entityId: number, externalNumber: string|null, date: string, lines: Array<object>}>` — The delivery.
|
||||
|
||||
**Throws**
|
||||
|
||||
@@ -86,7 +87,7 @@ Returns a single delivery by its id within the user's selected company.
|
||||
|
||||
```js
|
||||
const delivery = await store.delivery.getById(42, 5);
|
||||
// => { id, number, type, entityId, date, lines: [...] }
|
||||
// => { id, number, type, entityId, externalNumber, date, lines: [...] }
|
||||
```
|
||||
|
||||
## `delivery.list`
|
||||
@@ -103,13 +104,13 @@ Lists the deliveries of the user's selected company.
|
||||
|
||||
**Returns**
|
||||
|
||||
`Promise<Array<{id: number, number: string, type: string, entityId: number, date: string}>>` — The deliveries.
|
||||
`Promise<Array<{id: number, number: string, type: string, entityId: number, externalNumber: string|null, date: string}>>` — The deliveries.
|
||||
|
||||
**Example**
|
||||
|
||||
```js
|
||||
const deliveries = await store.delivery.list(42);
|
||||
// => [{ id, number, type, entityId, date }]
|
||||
// => [{ id, number, type, entityId, externalNumber, date }]
|
||||
```
|
||||
|
||||
## `delivery.update`
|
||||
@@ -128,11 +129,12 @@ Updates a delivery's header and/or lines.
|
||||
| `[patch.number]` | `string` | The new delivery number. |
|
||||
| `[patch.date]` | `string` | The new delivery date. |
|
||||
| `[patch.supplierId]` | `number` | The new supplier id. |
|
||||
| `[patch.externalNumber]` | `string` | The new external (supplier) reference number. |
|
||||
| `[patch.lines]` | `Array<object>` | The new delivery lines. |
|
||||
|
||||
**Returns**
|
||||
|
||||
`Promise<{id: number, number: string, type: string, entityId: number, date: string, lines: Array<object>}>` — The updated delivery.
|
||||
`Promise<{id: number, number: string, type: string, entityId: number, externalNumber: string|null, date: string, lines: Array<object>}>` — The updated delivery.
|
||||
|
||||
**Throws**
|
||||
|
||||
|
||||
Reference in New Issue
Block a user