Create Dropship Purchase Order
This API will create dropship POs for a Sales Order. It is used when items need to be shipped directly from a vendor to the customer, bypassing internal warehouse processing. You need to provide the Sales Order number, the specific line ID, vendor ID, and quantity.
Field
Data Type
Default Value
Description
SalesOrderNumber
string
NA
Sales Order number for which the dropship PO is being created.
OrderLines
array
[]
Array containing the line-level dropship details.
SoLineId
integer
NA
Sales Order line ID selected for dropshipping.
VendorId
integer
NA
ID of the vendor who will fulfill the dropship order.
Qty
decimal
0
Quantity to be dropshipped.
post
Authorizations
AuthorizationstringRequired
Body
SalesOrderNumberstringOptional
Responses
200
OK
application/json
IsForwardRequestbooleanOptional
MessagestringOptional
MessageTitlestring · nullableOptional
ResultbooleanOptional
post/api/xerp/purchaseorder/createdropshippobyso
POST /api/xerp/purchaseorder/createdropshippobyso HTTP/1.1
Host: res.xorosoft.io
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 97
{
"OrderLines": [
{
"Qty": 1,
"SoLineId": "183615",
"VendorId": "1334"
}
],
"SalesOrderNumber": "HQ1-S006839"
}200
OK
{
"Data": [
{
"poHeader": {
"Account3PLCode": null,
"Account3PLId": 0,
"AddressVerificationIdentifierCode": null,
"ApplyPricingRule": false,
"ApproverName": null,
"AsnNotes": null,
"AsnNumbers": null,
"AutoGenerateAsn": false,
"AutoReleasePurchaseOrder": false,
"BillFromAddrHashCode": 0,
"BillFromAddress": "3805 Bridgeport Rd",
"BillFromAddress2": "STREET 101",
"BillFromCity": "Uxbridge",
"BillFromCompanyName": "Company12",
"BillFromCountry": "CANADA",
"BillFromEmail": "company@yopmail.com",
"BillFromFirstName": "FirstName",
"BillFromLastName": "LastName",
"BillFromName": "Test User",
"BillFromPhoneNumber": "905-852-7733",
"BillFromPostalZipCode": "L9P 1H2",
"BillFromState": "Ontario",
"BrandId": 0,
"BrandName": null,
"BuyerId": 4337,
"BuyerName": "Bing kicks",
"CancelReasonCode": null,
"CancelReasonName": null,
"CarrierCode": null,
"CarrierId": 1322,
"CarrierName": "Canada Post",
"CheckThirdPartySource": false,
"CombineLines": false,
"CreateDateTime": "07/21/2025 03:01:37 AM",
"CreateSource": "Test (API)",
"CurrencyCode": "CAD",
"CurrencyId": 1,
"CurrencyRate": 1,
"CurrencySymbol": "$ ",
"CustomFieldH1": "",
"CustomFieldH10": "",
"CustomFieldH11": "",
"CustomFieldH12": "",
"CustomFieldH13": "",
"CustomFieldH14": "",
"CustomFieldH15": "",
"CustomFieldH16": "",
"CustomFieldH17": "",
"CustomFieldH18": "",
"CustomFieldH19": "",
"CustomFieldH2": "",
"CustomFieldH20": "",
"CustomFieldH21": "",
"CustomFieldH22": "",
"CustomFieldH23": "",
"CustomFieldH24": "",
"CustomFieldH25": "",
"CustomFieldH26": "",
"CustomFieldH27": "",
"CustomFieldH28": "",
"CustomFieldH29": "",
"CustomFieldH3": "",
"CustomFieldH30": "",
"CustomFieldH31": "",
"CustomFieldH32": "",
"CustomFieldH33": "",
"CustomFieldH34": "",
"CustomFieldH35": "",
"CustomFieldH36": "",
"CustomFieldH37": "",
"CustomFieldH38": "",
"CustomFieldH39": "",
"CustomFieldH4": "",
"CustomFieldH40": "",
"CustomFieldH41": "",
"CustomFieldH42": "",
"CustomFieldH43": "",
"CustomFieldH44": "",
"CustomFieldH45": "",
"CustomFieldH46": "",
"CustomFieldH47": "",
"CustomFieldH48": "",
"CustomFieldH49": "",
"CustomFieldH5": "",
"CustomFieldH50": "",
"CustomFieldH6": "",
"CustomFieldH7": "",
"CustomFieldH8": "",
"CustomFieldH9": "",
"Customer3PLMainEmail": null,
"DateExpectedDelivery": "08/10/2025",
"DateFulFilled": null,
"DateOrder": "07/21/2025",
"DateReleased": "07/21/2025",
"DefaultLocationId": null,
"DefaultLocationName": "",
"DeletedOrderLinkingArr": null,
"DiscountAmount": 0,
"DropShipCustomerId": null,
"DropShipCustomerName": "",
"DropshipFreightAmount": 0,
"EntityUseCode": null,
"ExpectedShipDate": "08/10/2025",
"FobId": null,
"FobName": null,
"FromStoreDefaultLocationName": null,
"HashCodeJson": null,
"Id": 87031,
"InvalidAddressFlag": false,
"IsAccount3plApiRequest": false,
"IsApprovalRequiredFlag": false,
"IsApproved": false,
"IsClosed": false,
"IsDropShip": true,
"IsExistingPOLine": false,
"IsProcessed": false,
"ItemQualityCode": null,
"KeepOriginalOrderNumber": false,
"LastApprovedAmount": 0,
"LastApprovedDateTime": null,
"LastApprovedSource": null,
"LineCount": 0,
"LinkSOToPO": false,
"LinkedSO": null,
"MainEmail": null,
"MainPhone": null,
"Memo": "",
"MoNumbers": null,
"ModifyDateTime": null,
"ModifySource": "",
"OpenPageFromSO": false,
"OrderClassCode": null,
"OrderClassName": null,
"OrderNumber": "HQ1-P001840",
"POApprovalStatus": null,
"PaymentTermsId": null,
"PaymentTermsName": null,
"PoSubTypeId": null,
"PoSubTypeName": "",
"PreserveOrderLinking": true,
"ProcessedDttm": null,
"ProcessedSource": null,
"ProjectClassId": null,
"ProjectClassName": "",
"QualityId": null,
"ReceivingStatusId": 2659,
"ReceivingStatusName": "Pending Asn",
"RefId": null,
"RefNumber": "HQ1-S006839",
"ReportDataObj": {
"EntityAccntId": "5840C779-828E-4C05-837F-689C48983F12",
"EntityName": "VENDOR COMPANY",
"EntityObj": null,
"ReportEntityId": 105,
"TxnRefId": 87031,
"TxnRefNumber": "HQ1-P001840",
"TxnTypeId": 114,
"linkedTxnRefId": null
},
"ShipFromAddress": null,
"ShipFromAddress2": null,
"ShipFromCity": null,
"ShipFromCountry": null,
"ShipFromPostalZipCode": null,
"ShipFromState": null,
"ShipMethodId": 10,
"ShipMethodName": "Pick Up",
"ShipServiceCode": null,
"ShipServiceId": 33,
"ShipServiceName": "Xpresspost",
"ShipToAddrHashCode": 0,
"ShipToAddrName": null,
"ShipToAddress": "Mr. Bing St. Catharines Ontario Canada Bing kicks +1565666511 2996 St Paul St 20 20 L2R",
"ShipToAddress2": "20",
"ShipToCity": "St. Catharines",
"ShipToCompanyName": "Bing kicks",
"ShipToCountry": "Canada",
"ShipToEmail": "test007@yopmail.com",
"ShipToFirstName": "Mr.",
"ShipToLastName": "Bing",
"ShipToName": "Mr. Bing",
"ShipToPhoneNumber": "+1565666511",
"ShipToPostalZipCode": "L2R",
"ShipToState": "Ontario",
"ShippingAccountNumber": "",
"ShippingTermsId": null,
"ShippingTermsName": null,
"StatusId": 20,
"StatusName": "Released",
"StoreId": 11105,
"StoreName": "HQ1",
"SubTotal": 0,
"SubTotalExclDiscount": 0,
"Tags": "",
"TaxServiceHashCode": 0,
"TaxServiceHashCodeOld": 0,
"TaxSummaryDataText": null,
"ThirdPartyDisplayName": "",
"ThirdPartyIconUrl": "",
"ThirdPartyOrderAlreadyExists": false,
"ThirdPartyRefNo": "",
"ThirdPartySource": "",
"ToStoreDefaultLocationId": null,
"ToStoreDefaultLocationName": "",
"TotalAmount": 1,
"TotalCBM": 0,
"TotalEstimatedDutyAmount": null,
"TotalPrepayment": 0,
"TotalQty": 1,
"TransferFromStoreId": null,
"TransferFromStoreName": "",
"TransferProcessedFlag": false,
"TransferSoId": null,
"TransferSoNumber": "",
"TransferToStoreId": null,
"TriggerIncomingPoDeliveryWebhookFlag": true,
"TxnId": "",
"TxnNumber": 0,
"TxnTypeId": null,
"TypeId": 10,
"TypeName": "Purchase",
"UpdateEnable": false,
"UpdateFromSo": false,
"UpdatedOrderLinkingArr": null,
"Vendor3PLTypeId": 0,
"Vendor3PLTypeName": null,
"VendorContact": "",
"VendorEmailCC": null,
"VendorEmailMain": "er@yopmail.com",
"VendorId": 1334,
"VendorMsg": "",
"VendorName": "KOTA STONE SUPPLIER VERDOR COMPANY",
"VendorPartNumber": "Test",
"VendorReqDate": "07/21/2025",
"VoidAndCreate": false,
"VoidTSO": false
},
"poLines": [
{
"Account3plId": null,
"AllowedPurchaseUOMList": null,
"AlternativeItemNumber1": "",
"AlternativeItemNumber2": "",
"AlternativeItemNumber3": "",
"Amount": 1,
"BasePartNumber": "Zoro Base Product Number",
"BaseQtyOrdered": null,
"BaseQtyRemainingToShip": null,
"BaseQtyShipped": null,
"BaseUomId": 1,
"BaseUomName": null,
"BrandName": null,
"CancelledFlag": false,
"CloseFlag": false,
"CreateDateTime": null,
"CreateSource": null,
"CustomFieldD1": "",
"CustomFieldD10": "",
"CustomFieldD11": "",
"CustomFieldD12": "",
"CustomFieldD13": "",
"CustomFieldD14": "",
"CustomFieldD15": "",
"CustomFieldD16": "",
"CustomFieldD17": "",
"CustomFieldD18": "",
"CustomFieldD19": "",
"CustomFieldD2": "",
"CustomFieldD20": "",
"CustomFieldD21": "",
"CustomFieldD22": "",
"CustomFieldD23": "",
"CustomFieldD24": "",
"CustomFieldD25": "",
"CustomFieldD26": "",
"CustomFieldD27": "",
"CustomFieldD28": "",
"CustomFieldD29": "",
"CustomFieldD3": "",
"CustomFieldD30": "",
"CustomFieldD31": "",
"CustomFieldD32": "",
"CustomFieldD33": "",
"CustomFieldD34": "",
"CustomFieldD35": "",
"CustomFieldD36": "",
"CustomFieldD37": "",
"CustomFieldD38": "",
"CustomFieldD39": "",
"CustomFieldD4": "",
"CustomFieldD40": "",
"CustomFieldD41": "",
"CustomFieldD42": "",
"CustomFieldD43": "",
"CustomFieldD44": "",
"CustomFieldD45": "",
"CustomFieldD46": "",
"CustomFieldD47": "",
"CustomFieldD48": "",
"CustomFieldD49": "",
"CustomFieldD5": "",
"CustomFieldD50": "",
"CustomFieldD6": "",
"CustomFieldD7": "",
"CustomFieldD8": "",
"CustomFieldD9": "",
"DateExpectedDelivery": "08/10/2025",
"DateLastFulFilled": null,
"DefaultPurchaseUomId": 0,
"DeleteFlag": false,
"Description": "DropShip Item",
"Discount": 0,
"DiscountDisp": "0%",
"DiscountTypeId": 10,
"DiscountTypeName": null,
"DropshipSoId": null,
"DropshipSoLineId": null,
"DropshipSoNumber": "",
"EditState": true,
"EffectiveUnitPrice": 1,
"EstimatedDutyAmount": null,
"EstimatedDutyPercentage": null,
"ExpectedShipDate": "08/10/2025",
"HSCode": null,
"Id": 97665,
"ImagePath": null,
"IsBomItemFlag": false,
"IsCopiedFromSO": false,
"IsKitHeader": false,
"IsKitItem": false,
"IsMergedChildLine": false,
"IsMergedParentLine": false,
"IsPriceChanged": false,
"IsProducibleFlag": false,
"IsTaxableFlag": true,
"ItemBarcode": "",
"ItemCategoryName": null,
"ItemGroupName": null,
"ItemIdentifierCode": null,
"ItemQualityCode": null,
"ItemSubCategoryName": null,
"ItemUpc": "",
"ItemWeight": null,
"ItemWeightUomId": 8,
"ItemWeightUomName": "Gram",
"KitItemFactor": 1,
"LineStatusId": 20,
"LineStatusName": "Released",
"LinkedQty": 0,
"LinkedSoNumbers": null,
"MasterKitId": null,
"MasterKitKey": "",
"MaterialName": "100% Cotton",
"ModifyDateTime": null,
"ModifySource": null,
"Notes": "",
"OpenFlag": false,
"Option1Name": "OptionSize",
"Option1Seq": null,
"Option1Value": "",
"Option1ValueCode": "",
"Option2Name": "Color",
"Option2Seq": 1,
"Option2Value": "BLACK",
"Option2ValueCode": "BLACK",
"Option3Name": null,
"Option3Seq": null,
"Option3Value": null,
"Option3ValueCode": null,
"OrderLineClassCode": null,
"OrderLineClassName": null,
"OrderNumber": null,
"PoId": 87031,
"PoItemId": 76551,
"PoItemNumber": "DropShip Item",
"PoItemTypeId": 10,
"PoItemTypeName": "Inventory",
"PoLineNumber": 1,
"ProductCategoryName": null,
"ProductHeaderId": 30878,
"ProjectClassId": null,
"ProjectClassName": "",
"PtoId": null,
"PurchaseNotes": "",
"QtyAvailableToReceive": null,
"QtyDecimalFlag": true,
"QtyInReceiving": 0,
"QtyOpenAsn": null,
"QtyOrder": 1,
"QtyReceived": 0,
"QtyReceivedPercentage": 0,
"QtyRemaining": 1,
"QtyToReceive": null,
"QualityId": null,
"ReceivedQuality": null,
"RefId": null,
"SoId": null,
"SoLineId": null,
"SoLineQty": null,
"TaxAmount": 0,
"TaxCategoryCode": null,
"TaxCodeId": null,
"TaxCodeName": "",
"TaxData": null,
"TaxItems": null,
"ThirdPartyRefNo": null,
"Title": "Zoro Product Title",
"TotalInReceiving": null,
"TransferSoLineId": null,
"TxnTypeId": null,
"UnitCBM": null,
"UnitPrice": 1,
"UomFactor": 1,
"UomId": 1,
"UomName": "Each",
"VendorId": null,
"VendorPartNumber": "Test"
}
],
"uccCartonArr": null
}
],
"IsForwardRequest": false,
"Message": "DropShip POs created successfully",
"MessageTitle": null,
"Result": true
}Last updated
Was this helpful?