Skip to main content
PUT
/
delivery-notes
/
{id}
Update delivery note
const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://api.dolfinai.co/delivery-notes/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "dnNumber": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "organisationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "supplierId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "externalRef": "<string>",
  "purchaseOrderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "receivedAt": "2023-11-07T05:31:56Z",
  "lines": [
    {
      "description": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sku": "<string>",
      "quantityReceived": 123,
      "unit": "<string>",
      "sortOrder": 123,
      "matchedQuantity": 123,
      "fullyMatched": true
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Path Parameters

​
id
string<uuid>
required

Body

application/json

Full-representation update of a delivery note and its lines. Lines with a known id are updated in place, lines with no id are added, and omitted lines are removed. A line already matched to a bill cannot be removed or have its received quantity dropped below what is already matched.

​
supplierId
null | string<uuid>

Supplier the goods were received from. Optional.

​
externalRef
null | string

Caller's own reference for the note. Optional.

​
dnNumber
null | string

Human delivery-note number. Required.

​
purchaseOrderId
null | string<uuid>

Loose header link to a purchase order. Optional.

​
receivedAt
null | string<date-time>

When the goods were received. Optional.

​
lines
object[]

The full set of received lines after the edit.

Response

OK

A delivery note and its received lines.

​
dnNumber
string
required

Human delivery-note number. Required and unique within the organisation.

​
id
string<uuid>

Unique identifier of the delivery note.

​
organisationId
string<uuid>

The organisation that owns the delivery note.

​
supplierId
null | string<uuid>

The supplier the goods were received from, if assigned.

​
externalRef
null | string

Caller's own reference for the note (a reverse pointer to the platform's record), if any.

​
purchaseOrderId
null | string<uuid>

Loose header link to a purchase order, if one was provided. Optional.

​
receivedAt
null | string<date-time>

When the goods were received, if recorded.

​
status
enum<string>

Lifecycle status: Draft, Open, PartiallyMatched, FullyMatched (all derived from matching), or the manual terminal states Closed / Cancelled.

Available options:
Draft,
Open,
PartiallyMatched,
FullyMatched,
Closed,
Cancelled
​
lines
object[]

The received lines, in display order.

​
createdAt
string<date-time>

When the delivery note was created.

​
updatedAt
string<date-time>

When the delivery note was last updated.