Preadviezen (ASN)

Beheer inbound preadviezen (Advanced Shipping Notices). Een preadvies bevat informatie over een verwachte levering van een leverancier.

Endpoints

Methode	Pad	Beschrijving
`GET`	`/preadvices`	Alle preadviezen ophalen
`POST`	`/preadvices`	Preadvies aanmaken (incl. regels)
`GET`	`/preadvices/:id`	Specifiek preadvies ophalen (incl. regels)
`PUT`	`/preadvices/:id`	Preadvies bijwerken
`DELETE`	`/preadvices/:id`	Preadvies verwijderen (incl. regels)
`GET`	`/preadvices/:id/lines`	Preadviesregels ophalen
`POST`	`/preadvices/:id/lines`	Preadviesregels toevoegen
`GET`	`/preadvices/:id/lines/:line_id`	Specifieke preadviesregel ophalen
`PUT`	`/preadvices/:id/lines/:line_id`	Preadviesregel bijwerken
`DELETE`	`/preadvices/:id/lines/:line_id`	Preadviesregel verwijderen

Alle preadviezen ophalen

GET /preadvices

Response `200 OK`

[
  {
    "id": 1,
    "pre_advice_id": "PA-001",
    "client_id": "CLIENT01",
    "pre_advice_status": {
      "id": 1,
      "description": "Open"
    },
    "pre_advice_status_description": "Open",
    "supplier": {
      "id": 3,
      "name": "Leverancier BV - Rotterdam"
    },
    "supplier_id": 3,
    "creation_datetime": "14-03-2026 10:00:00",
    "created_by": "admin"
  }
]

Preadvies aanmaken

POST /preadvices

Request

{
  "pre_advice_id": "PA-001",
  "supplier": 3,
  "client_id": "CLIENT01",
  "lines": [
    {
      "sku_id": "SKU-001",
      "qty": 100,
      "pallet_id": "PLT-001",
      "client_id": "CLIENT01"
    },
    {
      "sku_id": "SKU-002",
      "qty": 50,
      "pallet_id": "PLT-001"
    }
  ]
}

Preadvies header velden

Veld	Type	Verplicht	Beschrijving
`pre_advice_id`	string	✅	Uniek preadvies ID
`supplier`	number	Nee	ID van de leverancier (uit `/suppliers`)
`client_id`	string	Nee	Client ID (voor fulfillment)
`lines`	array	Nee	Preadviesregels

Preadviesregel velden

Veld	Type	Verplicht	Beschrijving
`sku_id`	string	✅	Artikel-ID
`qty`	number	✅	Verwacht aantal
`line`	number	Nee	Regelnummer (auto-generated indien weggelaten)
`pallet_id`	string	Nee	Pallet ID (voor pallet-ontvangst)
`client_id`	string	Nee	Client ID op regelniveau (overschrijft header)

Response `204 No Content`

Response `409 Conflict`

{
  "message": "PreAdvice with PreAdviceID PA-001 already exists"
}

Specifiek preadvies ophalen

GET /preadvices/:id

Response `200 OK`

{
  "pre_advice_id": "PA-001",
  "client_id": "CLIENT01",
  "pre_advice_status": {
    "id": 1,
    "description": "Open"
  },
  "supplier": {
    "id": 3,
    "name": "Leverancier BV - Rotterdam"
  },
  "creation_datetime": "14-03-2026 10:00:00",
  "created_by": "admin",
  "lines": [
    {
      "pre_advice_id": "PA-001",
      "line": 1,
      "sku_id": "SKU-001",
      "qty": 100,
      "qty_received": 0,
      "pallet_id": "PLT-001",
      "client_id": "CLIENT01"
    }
  ]
}

Response `404 Not Found`

{
  "message": "PreAdvice with PreAdviceID PA-001 not found"
}

Preadvies bijwerken

PUT /preadvices/:id

Request

{
  "supplier": 4,
  "client_id": "CLIENT02"
}

Response `204 No Content`

Preadvies verwijderen

DELETE /preadvices/:id

Verwijdert het preadvies inclusief alle regels.

Response `204 No Content`

Preadviesregels toevoegen

POST /preadvices/:id/lines

Request

{
  "sku_id": "SKU-003",
  "qty": 200,
  "pallet_id": "PLT-002",
  "client_id": "CLIENT01"
}

Response `204 No Content`

Preadviesregel bijwerken

PUT /preadvices/:id/lines/:line_id

Request

{
  "sku_id": "SKU-003",
  "qty": 250,
  "pallet_id": "PLT-002",
  "client_id": "CLIENT01"
}

Response `204 No Content`

Preadviesregel verwijderen

DELETE /preadvices/:id/lines/:line_id