Overview

The Delivery Notes API enables you to:

Create and manage delivery notes for purchase orders
Automatically process supplier delivery notes to pre-fill goods receipts
Handle multiple delivery notes for a single purchase order
Manage delivered quantities, prices, and order lines information

Relationship with Purchase Orders

A delivery note is always associated with a purchase order and documents what was actually delivered versus what was ordered. The system supports several scenarios:

Multiple Delivery Notes per Purchase Order

When a purchase order is delivered in multiple shipments, you can create multiple delivery notes for the same purchase order. Each delivery note will:

Be appended to the end of the existing list of delivery notes
Maintain its own delivered quantities and line order lines
For goods receipts, only the first delivery note is considered by default

Handling Delivered Articles

The system intelligently handles different scenarios when processing delivery notes:

Case I: Ordered and Known Articles

When the delivery note contains order lines that were ordered and exist in your system, they are automatically matched and the goods receipt is pre-filled with the delivered quantities, prices, and the returnable prices.

Case II: Unordered Known Articles

When the delivery note contains order lines that exist in your system but were not on the original purchase order, these items are flagged as unordered additions that can be accepted during the goods receipt process.

Case III: Unknown Articles

When the delivery note contains order lines not yet in your system (new or replacement order lines), these order lines cannot be processed in the goods receipt until a stock item and supplier package are created for them. The system captures article names, quantities, and prices from the delivery note to facilitate creating these records during the goods receipt workflow.

Delivery Note Information

Delivery notes capture comprehensive information at both the document and line-article levels, including supplier details, delivery dates and times, delivery note numbers, purchase order references, receiving outlet locations, article numbers and names, delivered quantities (with support for decimals and corrections), package information, GTIN/EAN codes, prices, VAT codes, and returnable packaging details.