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

fetch('https://api.dolfinai.co/delivery-notes', 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"
}

Body

application/json

Creates a delivery note with its received lines.

​
supplierId
null | string<uuid>

Supplier the goods were received from. Optional — may be assigned later.

​
externalRef
null | string

Caller's own reference for the note (a reverse pointer to the platform's record). 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 received lines. At least one is required.

Response

Created

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.