## Record a delivery note from snapshots (tenant:trade:sales:write)

`POST /api/trade/v1/delivery-notes`

Module: Trade · operationId: `createIssuedDeliveryNote` · Tag: Issued documents · Auth: access token (`Authorization: Bearer <accessToken>`)

Stores a `DELIVERY_NOTE` with status `delivered`. Publishes `trade.deliverynote.created`.

### Request body

`application/json` (required)

- `addressId` (string (uuid)): Masterdata address of the customer.
- `addressSnapshot` (AddressSnapshot): Frozen copy of the partner address (GoBD).
- `deliveryNoteNumber` (string): Number of the delivery note.

Example:

```json
{
  "addressId": "3c5e7a91-2b4d-4f6a-8c1e-5d7f9a0b1c05",
  "addressSnapshot": {
    "city": "Neutraubling",
    "companyName": "Donau Maschinenbau AG",
    "country": "DE",
    "street": "Werkstraße 100",
    "zip": "93073"
  },
  "deliveryNoteNumber": "LS-2026-0213"
}
```

### Responses

- **201** Recorded (`application/json`)
- **400** Error (`application/json`)
- **401** No valid session or bearer token (no body).

Fields of the 201 answer:

- `addressId` (string): Masterdata address of the customer.
- `addressSnapshot` (AddressSnapshot): Frozen copy of the partner address (GoBD).
- `createdAt` (string (date-time)): When the delivery note was created.
- `customerNo` (string): Customer number of the tenant.
- `deliveryNoteNumber` (string): Number of the delivery note.
- `id` (string (uuid)): Id of the delivery note.
- `status` (string): Status of the delivery note.
- `tenantName` (string): Name of the tenant.

Example 201 answer:

```json
{
  "addressId": "3c5e7a91-2b4d-4f6a-8c1e-5d7f9a0b1c05",
  "addressSnapshot": {
    "city": "Neutraubling",
    "companyName": "Donau Maschinenbau AG",
    "country": "DE",
    "street": "Werkstraße 100",
    "zip": "93073"
  },
  "createdAt": "2026-11-19T13:40:00Z",
  "customerNo": "99999",
  "deliveryNoteNumber": "LS-2026-0213",
  "id": "6d9e0f1a-2b3c-4d4e-8f5a-7b8c9d0e1f04",
  "status": "delivered",
  "tenantName": "DEMO"
}
```

### Example request

```bash
curl -X POST 'https://api.mbcom.cloud/api/trade/v1/delivery-notes' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"addressId":"3c5e7a91-2b4d-4f6a-8c1e-5d7f9a0b1c05","addressSnapshot":{"city":"Neutraubling","companyName":"Donau Maschinenbau AG","country":"DE","street":"Werkstraße 100","zip":"93073"},"deliveryNoteNumber":"LS-2026-0213"}'
```
