Description

API call updates the delivery header values.

Request Parameters

#	Name	Type	Required	Example	Description
1	SDelHkey	integer	0	58401	Delivery ID (SDelHKey from SDelHeader table). Either SDelHkey or DeliveryNumber must be provided.
2	SupplNr	string	0	MGS	(obsolete) Supplier number can not be changed on the delivery anymore
3	DeliveryNumber	integer	0	10250	Delivery number (SDelHNr from SDelHeader table). Either SDelHkey or DeliveryNumber must be provided.
4	Note	string	0	Goods received in good condition	Delivery note (free text field for additional information about the delivery)
5	extInvoiceNr	string	0	INV-2025-0042	External invoice number for delivery (used for matching with external system)
6	extOrderNr	string	0	PO-2025-00815	External order numbers from supplier (Matching supplier order numbers for delivery are automatically populated, when updating the values get overwritten).
7	UserName	string	0	MaxMustermann	Update user name (use when updating from web application). Defaults to API if not provided.
8	PiccoUser	string	0	warehouse01	Mobile user name (use when executing from a mobile device) Used for locking deliveries.
9	Status	string	0	NEW	Delivery status. Valid values: NEW (new delivery), INV (invoiced), CLS (closed). Note: Closing delivery does not automatically add items to stock.
10	LockDelivery	boolean	0	1	Lock the delivery while working on it
11	ExternalReceiptNr	string	0	EXT-2025-00417	External receipt number from supplier (must be unique per supplier)

Request body

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dem="https://api.pixi.eu/soap/demosandbox/">
   <soapenv:Header/>
   <soapenv:Body>
      <dem:pixiUpdateDelivery>
         <dem:SDelHkey>58401</dem:SDelHkey>
         <dem:DeliveryNumber>10250</dem:DeliveryNumber>
         <dem:Note>Goods received in good condition</dem:Note>
         <dem:extInvoiceNr>INV-2025-0042</dem:extInvoiceNr>
         <dem:extOrderNr>PO-2025-00815</dem:extOrderNr>
         <dem:UserName>MaxMustermann</dem:UserName>
         <dem:Status>NEW</dem:Status>
         <dem:LockDelivery>1</dem:LockDelivery>
         <dem:ExternalReceiptNr>EXT-2025-00417</dem:ExternalReceiptNr>
      </dem:pixiUpdateDelivery>
   </soapenv:Body>
</soapenv:Envelope>

Response

Body 1: Call status

#	Name	Type	Description
1	ReturnMSG	string	Return message description

Additional Notes

Closing a delivery: When changing the status to CLS (closed), items will not automatically be added to stock, regardless of the BatchBinItemsOnDelivery setting. Use pixiSetStockMultiple to add items to stock after closing.

Locking: A delivery can be locked by a mobile user, indicating that someone is currently processing it. You must use the same user that locked the document to unlock it.

ExternalReceiptNr: Must be unique per supplier. If the provided value already exists on another delivery for the same supplier, an error is returned.

Either SDelHkey or DeliveryNumber must be provided to identify the delivery.