Manage supplier delivery notes that document the actual order lines delivered for purchase orders, enabling automated goods receipt processing.
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.