IDN: Inbound Delivery Note
An inbound delivery note tracking goods receipt from a vendor, with quality checks, storage allocation, and compliance.
IDN definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches IDN.Entity properties
| Property | Value |
|---|---|
| Entity code | IDN |
| Display name | Inbound Delivery Note |
| Plural | Inbound Delivery Notes |
| Level | 25000 |
Use cases
IDN is the goods receipt entity, recording when physical deliveries arrive from vendors. It links to PO (purchase order) and VEN (vendor) to trace deliveries back to their procurement origin. The entity covers the full receiving workflow: tracking information (carrier, tracking number, waybill, container), receiving details (warehouse via SITE entity, dock/gate, bay, received/inspected by), quality checks (status, date, notes), package information (count, weight, volume, pallets, hazmat/fragile/temperature flags), documentation verification (invoice, packing list, certificates, customs), discrepancy management (type classification, description, resolution), storage instructions (location, temperature, humidity, special handling), put-away tracking, and compliance/audit (customs clearance, duties, taxes, regulatory compliance).
Fields
Delivery Information
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Delivery Name. |
status | enum | Yes | Valid ids: 1 (Pending), 2 (In Transit), 3 (Received), 4 (Receiving), 5 (Partially Received), 6 (Completed), 7 (Cancelled). |
purchaseOrder | reference → PO | Yes | Purchase Order. |
supplier | reference → VEN | Yes | Vendor. |
supplierDeliveryRef | text | Supplier Delivery Reference. | |
expectedDeliveryDate | date | Yes | Expected Delivery Date. |
actualDeliveryDate | datetime | Actual Delivery Date. | |
deliveryMethod | enum | Valid ids: 1 (Standard Ground), 2 (Express), 3 (Next Day Air), 4 (Freight), 5 (Sea Freight), 6 (Air Freight), 7 (Courier), 8 (Supplier Delivery), 9 (Customer Collection). |
Tracking Information
| Field | Type | Required | Notes |
|---|---|---|---|
carrierName | text | Carrier Name. | |
trackingNumber | text | Tracking Number. | |
trackingUrl | text (URL) | Link to carrier tracking page | |
waybillNumber | text | Waybill Number. | |
containerNumber | text | Container/Pallet Number. |
Receiving Details
| Field | Type | Required | Notes |
|---|---|---|---|
receivingWarehouse | reference → SITE | Yes | Receiving Warehouse. |
receivingDock | text | Receiving Dock/Gate. | |
receivingBay | text | Receiving Bay. | |
receivedBy | reference → user | Received By. | |
inspectedBy | reference → user | Inspected By. | |
qualityCheckStatus | enum | Valid ids: 1 (Not Required), 2 (Pending), 3 (In Progress), 4 (Passed), 5 (Failed), 6 (Partially Passed). | |
qualityCheckDate | datetime | Quality Check Date. | |
qualityNotes | text (multi-line) | Quality Check Notes. |
Package Information
| Field | Type | Required | Notes |
|---|---|---|---|
numberOfPackages | number | Number of Packages. | |
totalWeight | number | Total Weight (kg). | |
totalVolume | number | Total Volume (m³). | |
palletCount | number | Pallet Count. | |
temperatureControlled | boolean | Temperature Controlled. | |
hazardousMaterials | boolean | Contains Hazardous Materials. | |
fragileGoods | boolean | Contains Fragile Goods. |
Documentation
| Field | Type | Required | Notes |
|---|---|---|---|
invoiceNumber | text | Invoice Number. | |
invoiceDate | date | Invoice Date. | |
invoiceAmount | number | Invoice Amount. | |
packingListReceived | boolean | Packing List Received. | |
certificateOfOrigin | boolean | Certificate of Origin. | |
customsDocuments | boolean | Customs Documents. | |
qualityCertificates | boolean | Quality Certificates. | |
documentNotes | text (multi-line) | Document Notes. |
Discrepancies
| Field | Type | Required | Notes |
|---|---|---|---|
hasDiscrepancies | boolean | Has Discrepancies. | |
discrepancyType | enum | Valid ids: 1 (Quantity Mismatch), 2 (Damaged Goods), 3 (Wrong Items), 4 (Missing Items), 5 (Extra Items), 6 (Quality Issues), 7 (Documentation Issues). | |
discrepancyDescription | text (multi-line) | Discrepancy Description. | |
discrepancyResolution | text (multi-line) | Resolution Actions. |
Storage Instructions
| Field | Type | Required | Notes |
|---|---|---|---|
primaryStorageLocation | text | Primary Storage Location. | |
secondaryStorageLocation | text | Secondary Storage Location. | |
storageTemperature | enum | Valid ids: 1 (Ambient), 2 (Refrigerated (2-8°C)), 3 (Frozen (-20°C)), 4 (Deep Frozen (-80°C)), 5 (Controlled Room Temp (15-25°C)). | |
storageHumidity | text | Storage Humidity Requirements. | |
specialHandling | text (multi-line) | Special Handling Instructions. |
Inventory Allocation
| Field | Type | Required | Notes |
|---|---|---|---|
putAwayStatus | enum | Valid ids: 1 (Not Started), 2 (In Progress), 3 (Completed), 4 (On Hold). | |
putAwayDate | datetime | Put-Away Date. | |
putAwayBy | reference → user | Put-Away By. | |
inventoryAdjustmentRequired | boolean | Inventory Adjustment Required. | |
inventoryAdjustmentNotes | text (multi-line) | Adjustment Notes. |
Compliance Information
| Field | Type | Required | Notes |
|---|---|---|---|
regulatoryCompliance | boolean | Regulatory Compliance Verified. | |
customsClearance | enum | Valid ids: 1 (Not Required), 2 (Pending), 3 (In Progress), 4 (Cleared), 5 (Hold), 6 (Rejected). | |
customsReferenceNumber | text | Customs Reference Number. | |
importDuties | number | Import Duties. | |
importTaxes | number | Import Taxes. | |
complianceCertificates | text (multi-line) | Compliance Certificates. |
Audit Trail
| Field | Type | Required | Notes |
|---|---|---|---|
created | datetime | Created On. | |
ownerId | reference → user | Created By. | |
updated | datetime | Last Updated. | |
updatedId | reference → user | Updated By. | |
approvedBy | reference → user | Approved By. | |
approvalDate | datetime | Approval Date. |
Financial Information
| Field | Type | Required | Notes |
|---|---|---|---|
totalOrderValue | number | Total Order Value. | |
totalReceivedValue | number | Total Received Value. | |
varianceAmount | number | Variance Amount. | |
variancePercentage | number | Variance %. |
Document Attachments
| Field | Type | Required | Notes |
|---|---|---|---|
deliveryNoteUrl | text (URL) | Link to scanned delivery note | |
packingListUrl | text (URL) | Link to packing list document | |
invoiceUrl | text (URL) | Link to invoice | |
photosUrl | text (URL) | Link to delivery photos or damage evidence | |
qualityReportUrl | text (URL) | Link to quality inspection report | |
customsDocumentsUrl | text (URL) | Link to customs clearance documents |
Additional panels
- Activity timeline panel attached.
Relationships
- Lookups:
purchaseOrderpoints at aPOrecord;supplierpoints at aVENrecord;receivingWarehousepoints at aSITErecord;receivedBypoints at a user;inspectedBypoints at a user;putAwayBypoints at a user;ownerIdpoints at a user;updatedIdpoints at a user;approvedBypoints at a user. - Related lists:
IDNLINE(formatSUB|IDN),SUBCOMP(formatSUB|IDN|SUBCOMP).
Creating a Inbound Delivery Note via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "IDN",
"level": 25000,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Example",
"status": "1",
"purchaseOrder": "",
"supplier": ""
}
Listing Inbound Delivery Notes
# All records in your tenant
GET /v1/entities/IDN/SUB:<your-sub-id>