pixi Developer & Integration Documentation

pixiSupplierOrderLineCreate

Description

Create new purchase order line for one supplier


Request Parameters

# Name Type Required Example Description
1 SupplierOrderId integer 0 12345 Purches order Id
2 SupplierOrderNr integer 0 70012345 Purches order number
3 UserName string 0 API user User name of user who execute API call
4 ConsiderPackageUnits boolean 0 0 or 1 Same functionality as at purchase order suggestions, apply (0 no, 1 yes) packing units
5 ConsiderMinOrderQty boolean 0 0 or 1 Same functionality as at purchase order suggestions, apply (0 no, 1 yes) minimum order quantity
6 PurchaseOrderXML string 1 check additional information Item XML see additional information tab

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:pixiSupplierOrderLineCreate>
         <dem:SupplierOrderId>12345</dem:SupplierOrderId>
         <dem:SupplierOrderNr>70012345</dem:SupplierOrderNr>
         <dem:UserName>API user</dem:UserName>
         <dem:ConsiderPackageUnits>0 or 1</dem:ConsiderPackageUnits>
         <dem:ConsiderMinOrderQty>0 or 1</dem:ConsiderMinOrderQty>
         <dem:PurchaseOrderXML>check additional information</dem:PurchaseOrderXML>
      </dem:pixiSupplierOrderLineCreate>
   </soapenv:Body>
</soapenv:Envelope>

Response


Body 1: Detailed result set

# Name Type Description
1 Status integer Status = Error|Success
2 StatusDescription integer Detail descripton of status
3 ItemId integer Item Id

Additional Notes

CAUTION: Only one item (per location) can be added per purchase order.
You can sent order quantity for more location.
In case of calculation of package unit, quantities for package unit will be adjusted per location and summarized together for total order quantity.

Using @ConsiderMinOrderQty = 1 and more location quantity for one item, min order quantity will be applied per location (not total item order quantity).

NOTE:	Fields ItemId, SupplierPrice, LocationId, OrderedQty and SupplierOrderId or SupplierOrderNr are MANDATORY
NOTE:	Purchase Order should have status NEW or BES (OPEN)
NOTE:	Supplier of the Purchase order and Item should match
NOTE:	DiscountType use 0 for % type and 1 for amount type. Discount Type and Discount are not mandatory. Default for Discount Type is PERCENT - Discount Type = 0.

**@PurchaseOrderXML** parameter sample XML:

<Items>
    <Item>
        <ItemId></ItemId>
        <SupplierPrice></SupplierPrice>
        <DiscountType></DiscountType>
        <Discount></Discount>
        <PackagingUnit></PackagingUnit>
        <EstimatedDeliveryDate></EstimatedDeliveryDate>
        <Comment></Comment>
        <LocationList>
            <Location>
                <LocationId></LocationId>
                <OrderedQty></OrderedQty>
            </Location>
            <Location>
                <LocationId></LocationId>
                <OrderedQty></OrderedQty>
            </Location>
        </LocationList>
    </Item>
</Items>