## Discard a delivery note (tenant:trade:purchasing:write)

`POST /api/trade/v1/inbound-delivery-notes/{id}/reject`

Module: Trade · operationId: `rejectInboundDeliveryNote` · Tag: Inbound delivery notes · Auth: access token (`Authorization: Bearer <accessToken>`)

For documents that are no delivery note or came twice. The comment is recorded in the Verlauf. Not for posted notes.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string (uuid) | yes |  |

### Request body

`application/json` (required)

- `comment` (string, required): (max length 1000)

Example:

```json
{
  "comment": "Doppelt eingegangen – identisch mit LE-2026-00012."
}
```

### Responses

- **200** The delivery note (`application/json`)
- **400** Error (`application/json`)
- **401** No valid session or bearer token (no body).
- **404** Not found in the tenant. (`application/json`)
- **409** The current state does not allow the action (`code` `invalid_state` or `blocked`). (`application/json`)

Fields of the 200 answer:

- `autoPost` (AutoPostDecision): Verdict of the automatic goods receipt on an inbound delivery note, stored whenever the mode is not `off`.
  - `eligible` (boolean): Every condition holds: matched without discrepancy, every line on the order and delivered completely, from EGIS (per shipment) or read with enough confidence and covering every open line of the order (`match.uncoveredPoPositions` empty), order not chosen by a person.
  - `evaluatedAt` (string (date-time)): When the decision was evaluated.
  - `mode` (string): Mode of the automatic goods receipt when the verdict was made (`off`, `dryRun`, `on`). (one of `off`, `dryRun`, `on`)
  - `posted` (boolean): The system posted the goods receipt (mode `on`).
  - `reasons` (array of string): Each failed condition (German text).
  - `rule` (string): The rule an automatic post applied (German text), also in the protocol entry of the posting.
- `createdAt` (string (date-time)): When the delivery note was created.
- `deliveryDate` (string (date)): Delivery date.
- `deliveryNoteNumber` (string): The supplier's number.
- `dmsDocumentId` (string (uuid)): Missing for delivery notes EGIS reported (`source` egis).
- `error` (string): Why processing failed.
- `externalReference` (string): `egis:<EGIS order number>:<EGIS delivery note id>` for EGIS delivery notes (one per order the note covers).
- `extraction` (object): What the AI read; never changed afterwards. Not in lists.
  - `confidence` (number): Confidence of the extraction (0–1).
  - `customerNumber` (string): Our customer number at the supplier.
  - `deliveryDate` (string): Delivery date (YYYY-MM-DD).
  - `deliveryNoteNumber` (string): The supplier's delivery note number.
  - `lines` (array of InboundDeliveryNoteLine): Lines read from the document.
    - `articleNumber` (string): The masterdata article the line was assigned to.
    - `description` (string): Description of the line.
    - `ean` (string): EAN (GTIN) of the article.
    - `mpn` (string): Manufacturer part number.
    - `orderNumber` (string): Purchase order number printed on the line.
    - `position` (integer): Position number of the line.
    - `productId` (string): Masterdata article (product) id.
    - `quantity` (number): Delivered quantity.
    - `serialNumbers` (array of string): Serial numbers.
    - `unit` (string): Unit of measure.
    - `vendorArticleNo` (string): The supplier's article number as read.
  - `model` (string): AI model that read the document.
  - `notes` (string): Notes of the extraction.
  - `orderNumbers` (array of string): Order numbers stated on the delivery note.
  - `supplier` (Party)
    - `address` (string): Single-line address (e-invoice).
    - `city` (string): City.
    - `country` (string): Country.
    - `iban` (string): IBAN.
    - `name` (string): Name.
    - `street` (string): Street and house number.
    - `taxNumber` (string): Tax number.
    - `vatId` (string): VAT identification number.
    - `zip` (string): Postal code.
- `fullText` (string): OCR text; only in the single read.
- `id` (string (uuid)): Id of the delivery note.
- `lines` (array of InboundDeliveryNoteLine): Empty in lists.
  - `articleNumber` (string): The masterdata article the line was assigned to.
  - `description` (string): Description of the line.
  - `ean` (string): EAN (GTIN) of the article.
  - `mpn` (string): Manufacturer part number.
  - `orderNumber` (string): Purchase order number printed on the line.
  - `position` (integer): Position number of the line.
  - `productId` (string): Masterdata article (product) id.
  - `quantity` (number): Delivered quantity.
  - `serialNumbers` (array of string): Serial numbers.
  - `unit` (string): Unit of measure.
  - `vendorArticleNo` (string): The supplier's article number as read.
- `match` (DeliveryCheck): The check of the delivered lines against the open quantities (ordered − received) of the purchase order.
  - `discrepancies` (array of LockReason): `MINDERLIEFERUNG` (partial delivery, not blocking), `MEHRLIEFERUNG` (more than open), `UNBEKANNTE_POSITION`, `FEHLENDE_BESTELLUNG`, `BESTELLUNG_NICHT_GEFUNDEN`.
    - `article` (string): Article of the line.
    - `code` (string): E.g. `PREISABWEICHUNG`, `MENGENABWEICHUNG`, `DUPLIKAT`, `FEHLENDER_LIEFERANT`, `FEHLENDER_ARTIKEL`, `KEINE_E_RECHNUNG`, `NIEDRIGE_KONFIDENZ`, `EMPFAENGER_ABWEICHUNG`, `LIEFERANT_GESPERRT` (the supplier is blocked or payment-blocked in masterdata), `FEHLENDE_BESTELLUNG`, `BESTELLUNG_NICHT_GEFUNDEN`, `EGIS_ABWEICHUNG` (amounts differ from the distributor's invoice data in EGIS).
    - `description` (string): Human-readable explanation.
    - `isBlocking` (boolean): The reason blocks the release until it is accepted or overridden.
    - `position` (integer): Line position the reason refers to; 0 for the whole invoice.
    - `variance` (number): Variance found (amount or quantity).
  - `evaluatedAt` (string (date-time)): When the check ran.
  - `lines` (array of object): Result per delivery note line.
    - `deliveredQty` (number): Quantity delivered.
    - `description` (string): Description of the line.
    - `openQty` (number): Ordered minus received before this note.
    - `orderedQty` (number): Quantity ordered.
    - `poLineId` (string (uuid)): Empty when the line is not on the order.
    - `poPosition` (integer): Position on the purchase order.
    - `position` (integer): Position number of the line.
    - `result` (string): Result of the line. (one of `OK`, `SHORT`, `OVER`, `UNKNOWN_POSITION`)
    - `variance` (number): Delivered minus open (negative: partial delivery).
  - `status` (string): Outcome of the check against the purchase order. (one of `matched`, `discrepancy`)
  - `uncoveredPoPositions` (array of integer): Positions of order lines with an open quantity the note does not deliver at all (a partial delivery of the order; no discrepancy).
- `orderReference` (string): Order numbers named on the note.
- `posting` (object): The goods receipt posted from the delivery note.
  - `goodsReceiptId` (string (uuid)): Id of the goods receipt.
  - `grNumber` (string): Number of the goods receipt.
  - `postedAt` (string (date-time)): When it was posted.
  - `postedBy` (string): Who posted it.
- `purchaseOrderFixed` (boolean): A person chose the purchase order.
- `purchaseOrderId` (string (uuid)): Purchase order the delivery note was assigned to.
- `purchaseOrderNumber` (string): Number of the purchase order.
- `source` (string): `egis` for a delivery note EGIS reported for an order sent through it (structured, with serial numbers; no document, no AI reading). (one of `egis`)
- `status` (InboundDeliveryNoteStatus): `RECEIVED` waits for the text, `EXTRACTED` is read, `MATCHED` / `DISCREPANCY` checked against the purchase order (findings in `match.discrepancies`), `POSTED` booked as goods receipt, `FAILED` could not be read (`error`, retry with reprocess), `REJECTED` discarded by a person. (one of `RECEIVED`, `EXTRACTED`, `MATCHED`, `DISCREPANCY`, `POSTED`, `REJECTED`, `FAILED`)
- `supplierAddressId` (string (uuid)): Masterdata address of the supplier.
- `supplierAssignment` (object): How the supplier was found.
  - `confidence` (number): Confidence of the assignment (0–1).
  - `evidence` (string): What the assignment is based on.
  - `method` (string): How the supplier was found: `exact_vat`, `exact_iban`, `exact_number`, `supplier_number`, `semantic`, `llm`, `fallback` or `manual`.
- `supplierName` (string): Name of the supplier.
- `transactionNumber` (string): Internal number of the delivery note (e.g. `LE-2026-00001`).
- `updatedAt` (string (date-time)): When the delivery note was last changed.

Example 200 answer:

```json
{
  "createdAt": "2026-11-18T11:00:00Z",
  "deliveryDate": "2026-11-18",
  "deliveryNoteNumber": "LS-778812",
  "dmsDocumentId": "9f2a3b4c-5d6e-4f7a-8b8c-1d2e3f4a5b13",
  "id": "4e7f8a9b-0c1d-4e2f-9a3b-5c6d7e8f9a03",
  "lines": [
    {
      "articleNumber": "NW-2004",
      "description": "Netzwerkschrank 19 Zoll 12 HE",
      "orderNumber": "BE-2026-00068",
      "position": 1,
      "productId": "4b7d9f13-5e6a-4c8b-a1d2-3e4f5a6b7c04",
      "quantity": 1,
      "serialNumbers": [
        "RK12-26-0457"
      ],
      "unit": "STK",
      "vendorArticleNo": "KW-RACK12HE"
    },
    {
      "articleNumber": "NW-2005",
      "description": "Verlegekabel Cat.7 Simplex, 100 m",
      "orderNumber": "BE-2026-00068",
      "position": 2,
      "productId": "4b7d9f13-5e6a-4c8b-a1d2-3e4f5a6b7c05",
      "quantity": 3,
      "serialNumbers": [],
      "unit": "PAK",
      "vendorArticleNo": "KW-CAT7-100"
    }
  ],
  "status": "REJECTED",
  "supplierAddressId": "6d8f0a12-3c4e-4a5b-9d6f-7e8a9b0c1d02",
  "supplierName": "Kabelwerk Süd GmbH",
  "transactionNumber": "LE-2026-00014",
  "updatedAt": "2026-11-18T11:20:00Z"
}
```

### Example request

```bash
curl -X POST 'https://api.mbcom.cloud/api/trade/v1/inbound-delivery-notes/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/reject' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"comment":"Doppelt eingegangen – identisch mit LE-2026-00012."}'
```
