Process Dropship Order by Purchase Order
This API is used to confirm and close a dropship order using the related Purchase Order number. It allows you to post tracking and shipping details, freight, and invoice information for each order line that was dropshipped.
Field
Data Type
Default Value
Description
PurchaseOrderNumber
string
NA
The PO number associated with the dropship order.
PackingSlipNumber
string
NA
Packing slip number from the vendor.
TrackingNumber
string
NA
Carrier-provided tracking number.
CarrierName
string
NA
Name of the shipping carrier (e.g., UPS, FedEx).
ShipServiceName
string
NA
Shipping service used (e.g., USPS Priority Mail).
Freight
decimal
0
Shipping cost charged for the dropship.
ShipDate
string
NA
Date of shipment.
InvoiceDate
string
NA
Date of invoice issued.
OrderLines
array
[]
Array containing line-level dropship confirmation details.
Id
integer
NA
Unique identifier for the Sales Order line.
DropshipQty
decimal
0
Quantity of the item that was dropshipped.
post
Authorizations
AuthorizationstringRequired
Body
Responses
200
OK
application/json
IsForwardRequestbooleanOptional
MessagestringOptional
MessageTitlestring · nullableOptional
ResultbooleanOptional
post/api/xerp/purchaseorder/dropshiporderbypo
POST /api/xerp/purchaseorder/dropshiporderbypo HTTP/1.1
Host: res.xorosoft.io
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 294
{
"Orders": [
{
"CarrierName": "US Postal",
"Freight": 25.5,
"InvoiceDate": "2025-08-01",
"OrderLines": [
{
"DropshipQty": 1,
"Id": 106954
}
],
"PackingSlipNumber": "PKG-19",
"PurchaseOrderNumber": "LA01-P004226",
"ShipDate": "2025-08-01",
"ShipServiceName": "USPS Priority Mail",
"TrackingNumber": "1Z999AA10123456726"
}
]
}200
OK
{
"Data": {
"ErroList": [],
"invoiceObjList": [
{
"ImportError": null,
"IsBeingAutoCreated": false,
"SimulatationFlag": false,
"ThirdPartyRequestRawData": null,
"invoiceHeader": {
"AccntReceivableId": "B7744F1BD912C85895EA7D9E4A93",
"AccntReceivableName": null,
"Account3PLCode": null,
"Account3PLName": null,
"AddressVerificationIdentifierCode": null,
"AmountDue": 0,
"AmountPaid": 0,
"AmountToPay": 0,
"AuthorizationDetailList": null,
"AutoCreateCarrierFlag": false,
"AutoCreateCustomer": false,
"AutoPaymentTotalAmount": null,
"AutoProcessPayment": false,
"AutoProcessPaymentId": null,
"AutoProcessPaymentName": null,
"BOLNumber": "",
"BatchUploadFlag": false,
"BillToAddr": "8285 16th Avenue",
"BillToAddr2": "",
"BillToAddrHashCode": 0,
"BillToAddrName": "dd",
"BillToCity": "Burnaby",
"BillToCompanyName": "",
"BillToCountry": "CAN",
"BillToCountryISO2": null,
"BillToEmail": "",
"BillToFirstName": "",
"BillToLastName": "dd",
"BillToName": " dd",
"BillToPhoneNumber": "",
"BillToState": "BC",
"BillToStateAbbr": null,
"BillToStateName": null,
"BillToZpCode": "V3N 1R9",
"BrandId": null,
"BrandName": null,
"BuyerId": null,
"BuyerName": null,
"CardLast4Digit": null,
"CarrierCode": "US_Postal",
"CarrierId": 1367,
"CarrierName": "US Postal",
"ChequeNo": null,
"ContactEmail": null,
"ContactFirstName": null,
"ContactId": 20,
"ContactLastName": null,
"ContactPhoneNumber": null,
"ContactTitle": null,
"ContainerRefNumber": "",
"Contract3plId": 0,
"CounterNumber": "021336",
"CreateDttm": "07/21/2025 03:20:47 AM",
"CreateSource": "Test (API)",
"CreditApplied": 0,
"CurrencyCode": "CAD",
"CurrencyId": 1,
"CurrencyName": "Canadian Dollar",
"CurrencySymbol": null,
"CustomFieldH1": null,
"CustomFieldH10": null,
"CustomFieldH11": null,
"CustomFieldH12": null,
"CustomFieldH13": null,
"CustomFieldH14": null,
"CustomFieldH15": null,
"CustomFieldH16": null,
"CustomFieldH17": null,
"CustomFieldH18": null,
"CustomFieldH19": null,
"CustomFieldH2": null,
"CustomFieldH20": null,
"CustomFieldH21": null,
"CustomFieldH22": null,
"CustomFieldH23": null,
"CustomFieldH24": null,
"CustomFieldH25": null,
"CustomFieldH26": null,
"CustomFieldH27": null,
"CustomFieldH28": null,
"CustomFieldH29": null,
"CustomFieldH3": null,
"CustomFieldH30": null,
"CustomFieldH31": null,
"CustomFieldH32": null,
"CustomFieldH33": null,
"CustomFieldH34": null,
"CustomFieldH35": null,
"CustomFieldH36": null,
"CustomFieldH37": null,
"CustomFieldH38": null,
"CustomFieldH39": null,
"CustomFieldH4": null,
"CustomFieldH40": null,
"CustomFieldH41": null,
"CustomFieldH42": null,
"CustomFieldH43": null,
"CustomFieldH44": null,
"CustomFieldH45": null,
"CustomFieldH46": null,
"CustomFieldH47": null,
"CustomFieldH48": null,
"CustomFieldH49": null,
"CustomFieldH5": null,
"CustomFieldH50": null,
"CustomFieldH6": null,
"CustomFieldH7": null,
"CustomFieldH8": null,
"CustomFieldH9": null,
"CustomerAccountNumber": null,
"CustomerBillingMethodName": null,
"CustomerDefaultBillingEmail": null,
"CustomerDefaultShipmentEmail": null,
"CustomerEmailCC": null,
"CustomerEmailMain": "test@yopmail.com",
"CustomerFirstName": null,
"CustomerFullName": null,
"CustomerGroupId": null,
"CustomerGroupName": null,
"CustomerId": 7016,
"CustomerIdentifierCode": 0,
"CustomerLastName": null,
"CustomerMainPhone": null,
"CustomerMessage": "",
"CustomerName": " dd",
"CustomerPO": "",
"CustomerParentId": null,
"CustomerParentName": null,
"CustomerServiceRepEmail": null,
"CustomerServiceRepFullName": null,
"CustomerServiceRepId": "",
"CustomerTags": null,
"CustomerTaxCodeId": 3,
"CustomerTypeId3PL": 0,
"CustomerTypeName": null,
"DateOrder": null,
"DateToBeShipped": null,
"DefaultAccountReceivableName": null,
"DefaultBillingMethodTypeId": null,
"DepositApplied": 0,
"DiscountAccntId": null,
"DiscountAccntName": null,
"DiscountAmount": 0,
"DiscountApplied": 0,
"DiscountDate": "11/19/2025",
"DiscountDays": null,
"DiscountPercentage": null,
"DiscountToUse": 0,
"DiscountableAmount": 42,
"DocumentUrl": null,
"DueDate": "10/10/2025",
"DueDays": null,
"DueReminderDays": null,
"DueReminderEmailDate": null,
"DueReminderEmailSentDttm": null,
"EdiDocRespMessage": null,
"EdiDocStatus": null,
"EmailedFlag": false,
"EntityUseCode": null,
"ErrorOnTaxMismatch": false,
"ExchangeRate": 1,
"ExchangeRateFormula": null,
"FobId": 10,
"FobName": "Origin",
"FullPaymentDate": null,
"HashCodeJson": null,
"Id": 101279,
"ImportAsSingleCustomer": false,
"ImportError": null,
"IntAccntId": null,
"InvalidAddressFlag": false,
"InvoiceBatchId": null,
"InvoiceBatchNumber": null,
"InvoiceNumber": "LA01-I021336",
"Is3plBillingInvoice": false,
"IsBatchCreatedFromThirdParty": false,
"IsCardOnFile": null,
"IsContactOrderProcessingEmailFlag": false,
"IsContactPaymentEmailFlag": false,
"IsContactReminderEmailFlag": false,
"IsContactShipmentEmailFlag": false,
"IsEdiFlag": false,
"IsFirstInvoice": false,
"IsProcessed": false,
"IsShippingBillCreated": false,
"ItemIncomeAccountId": null,
"ItemIncomeAccountName": null,
"JobScheduleReRunFlag": false,
"JobScheduleRunFlag": false,
"LadingQty": null,
"LastEmailDttm": null,
"LastInvoicePaymentId": null,
"LastInvoicePaymentNumber": null,
"LastOverdueEmailDttm": null,
"LastOverdueEmailSentDttm": null,
"LastPaymentEmailSentDttm": null,
"LastPaymentEmailSentSource": null,
"LinkedShippingBillId": null,
"MarkAsShipped": false,
"MasterBOLNumber": "",
"MasterTrackingNumber": "1Z999AA10123456726",
"MatchedFlag": false,
"MaxDiscountAllowed": 0,
"Memo": "",
"ModifyDttm": null,
"ModifySource": null,
"NoTaxCompareFlag": false,
"NoTaxServiceRequestFlag": false,
"OldTxnDate": "01/01/0001",
"OpeningBalanceFlag": false,
"OrderProcessingEmail": null,
"OrderRefNo": null,
"OrderType": null,
"OrderTypeCode": null,
"OrderTypeId": 2,
"OrderTypeName": null,
"PackingSlipNumber": null,
"PaymentAmount": 0,
"PaymentEmail": null,
"PaymentEmailSentCount": 0,
"PaymentEmailSentFlag": false,
"PaymentLinkCount": 0,
"PaymentMethodName": null,
"PaymentMethodTypeId": null,
"PaymentMethodTypeName": null,
"PaymentRefNo": null,
"PaymentRefNo2": null,
"PaymentTermsId": 10,
"PaymentTermsName": "COD",
"PermissionGroupId": null,
"PortalAccountNumber": null,
"ProcessedDttm": null,
"ProcessedSource": null,
"ProjectClassId": null,
"ProjectClassName": null,
"ReCalcShippingTaxesFlag": false,
"ReCalcTaxesFlag": false,
"ReceiptNumber": null,
"RefId": null,
"RefNo": "LA01-S026054/01",
"ReminderEmail": null,
"ReportDataObj": {
"EntityAccntId": "7D5B8A57-1A34-49BB-BFF5-06F1E70A7461",
"EntityName": " dd",
"EntityObj": null,
"ReportEntityId": 108,
"TxnRefId": 101279,
"TxnRefNumber": "LA01-I021336",
"TxnTypeId": 109,
"linkedTxnRefId": null
},
"ReportingDataText": "",
"RestrictDueInvoiceEmailFlag": false,
"RestrictNewCustomerForSameEmail": false,
"RestrictOverdueInvoiceEmailFlag": false,
"RiskAnalysis": null,
"SaleStoreAddr": null,
"SaleStoreAddr2": null,
"SaleStoreAddrName": null,
"SaleStoreCity": null,
"SaleStoreCode": null,
"SaleStoreCompanyName": null,
"SaleStoreCountry": null,
"SaleStoreCountryISO2": null,
"SaleStoreEmail": null,
"SaleStoreFirstName": null,
"SaleStoreId": 10001,
"SaleStoreLastName": null,
"SaleStoreName": "Los Angeles",
"SaleStorePhoneNumber": null,
"SaleStoreState": null,
"SaleStoreStateAbbr": null,
"SaleStoreZpCode": null,
"SalesRepEmail": null,
"SalesRepFullName": null,
"SalesRepGroups": null,
"SalesRepId": "CG005",
"ShipConfirmationEmailSent": false,
"ShipConfirmationEmailSentDttm": null,
"ShipDate": "08/01/2025",
"ShipFromAddr": "1 WORLD WAY",
"ShipFromAddr2": "",
"ShipFromAddrName": "LA",
"ShipFromCity": "LOS ANGELES",
"ShipFromCompanyName": null,
"ShipFromCountry": "United States",
"ShipFromCountryISO2": null,
"ShipFromEmail": null,
"ShipFromFirstName": null,
"ShipFromLastName": null,
"ShipFromName": "",
"ShipFromPhoneNumber": null,
"ShipFromState": "CA",
"ShipFromStateAbbr": null,
"ShipFromZpCode": "90013",
"ShipMethodId": 30,
"ShipMethodName": "Delivery (Third Party)",
"ShipServiceCode": null,
"ShipServiceId": 237,
"ShipServiceName": "USPS Priority Mail",
"ShipToAddr": "8285 16th Avenue",
"ShipToAddr2": "",
"ShipToAddrHashCode": 0,
"ShipToAddrName": "dd",
"ShipToCity": "Burnaby",
"ShipToCompanyName": "",
"ShipToCountry": "CAN",
"ShipToCountryISO2": null,
"ShipToEmail": "",
"ShipToFirstName": "",
"ShipToLastName": "dd",
"ShipToName": " dd",
"ShipToPhoneNumber": "",
"ShipToState": "BC",
"ShipToStateAbbr": null,
"ShipToStateName": null,
"ShipToZpCode": "V3N 1R9",
"ShipmentEmail": null,
"ShipmentId": 87265,
"ShipmentRefNumber": "",
"ShippedBy": "Test (API)",
"ShippingAccountNumber": "",
"ShippingAmount": 25.5,
"ShippingCost": 25.5,
"ShippingCostCarrier": 25.5,
"ShippingCostCredited": null,
"ShippingExpenseAccntId": "729A02493211FEC2295FBC1924D2D",
"ShippingExpenseAccntName": null,
"ShippingNotes": "",
"ShippingTaxCodeId": null,
"ShippingTaxCodeName": null,
"ShippingTaxData": {
"taxItems": [],
"totalAmount": 0
},
"ShippingTaxDataSerialized": "{\r\n \"taxItems\": [],\r\n \"totalAmount\": 0.0\r\n}",
"ShippingTaxItems": null,
"ShippingTermsId": 30,
"ShippingTermsName": "Prepaid & Billed",
"ShippingTypeId": 10,
"ShippingTypeName": null,
"SoId": 157532,
"SoNumber": "LA01-S026054",
"SoRefNumber": "",
"SoSubTypeId": null,
"SoToInvoice": false,
"Sscc": null,
"StatusId": 10,
"StatusName": null,
"StoreCode": null,
"StoreId": 10001,
"StoreName": "Los Angeles",
"SubTotal": 42,
"SubTotalExclDiscount": 42,
"SysLockFlag": false,
"Tags": "",
"TaxCalcByAddress": false,
"TaxCalcByAddressDisable": false,
"TaxCalcCode": null,
"TaxCalcType": null,
"TaxOperationCountryCode": null,
"TaxServiceHashCode": 0,
"TaxServiceHashCodeOld": 0,
"TaxServiceRefNumber": null,
"TaxSummaryDataText": "{\r\n \"TaxCodeId\": 0,\r\n \"TaxSummaryLineList\": [],\r\n \"TotalTaxAmount\": 0.0\r\n}",
"ThirdPartyCompanyId": null,
"ThirdPartyCustomerId": null,
"ThirdPartyDefaultSKU": null,
"ThirdPartyDisplayName": "",
"ThirdPartyIconUrl": "",
"ThirdPartyInvoiceAlreadyExists": false,
"ThirdPartyNotes": "",
"ThirdPartyOrderDttm": null,
"ThirdPartyPennyRoundingSKU": null,
"ThirdPartyRefName": null,
"ThirdPartyRefNo": "",
"ThirdPartyShipmentMetadata": null,
"ThirdPartySource": "",
"ThirdPartyTotalAmount": null,
"ThirdPartyTotalTaxAmount": null,
"TotalAmount": 67.5,
"TotalPaidAmount": 0,
"TotalQty": 1,
"TotalTaxAmount": 0,
"TotalVasItemsCost": 0,
"TrackingNumbers": "1Z999AA10123456726",
"TxnDate": "08/01/2025",
"TxnId": "126AFD11BB030F47248E26464136",
"TxnNumber": 298933,
"TxnTypeId": null,
"TypeId": 10,
"UnPostTranFlag": false,
"UpdateEnable": false,
"UseDefaultSKUWhenError": false,
"UseThirdPartyPennyRoundingSKU": false,
"VASTotal": 0,
"WaveNumbers": null,
"Weight": null,
"WeightUomCode": null,
"WeightUomName": null,
"searchField": null
},
"invoiceItemLineArr": [
{
"Account3plName": null,
"AllowedSellUOMList": null,
"AuthorizationDetailList": null,
"BaseQtyOrdered": 1,
"BaseQtyRemainingToShip": null,
"BaseQtyShipped": null,
"BaseUomCode": null,
"BaseUomId": 1,
"BaseUomName": "Each",
"ChargeCode": null,
"ConractLineTypeId": 0,
"ContractLineId": 0,
"CreateDttm": "07/21/2025 03:20:47 AM",
"CreateSource": "(API)",
"CreditQty": 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": "",
"CustomerItemNumber": "",
"DefaultSellUomId": 0,
"DeleteFlag": false,
"Description": "new dropship item ",
"Discount": 0,
"DiscountPerQty": 0,
"DiscountPercentage": 0,
"DiscountTypeId": 20,
"DiscountTypeName": null,
"EdiStatusId": 10,
"EditState": false,
"EffectiveUnitPrice": 42,
"ExternalItemNumber": "",
"ForceSalesTaxCode": false,
"GLCodeName": null,
"HSCode": null,
"HasRestriction": false,
"Id": 142022,
"InventoryLocChangeList": null,
"InvoiceId": 101279,
"Is3plInvoiceLine": false,
"IsBomItemFlag": false,
"IsDropshipFlag": false,
"IsProducibleFlag": false,
"IsTaxableFlag": true,
"IsoCode2": "DZ",
"IsoCountryName": "Algeria",
"ItemAppLinkingWrapper": {
"ItemAppLinkingArr": [
{
"CreateDttm": "01/01/0001 12:00:00 AM",
"CreateSource": "",
"Id": 0,
"ItemId": 96817,
"ItemNumber": "dropship-item-1",
"LinkedAppAccountId": "",
"LinkedAppItemRefId": "",
"LinkedAppName": "",
"ModifyDttm": null,
"ModifySource": ""
}
],
"ItemId": 96817,
"ItemNumber": "dropship-item-1",
"ItemTags": null
},
"ItemCategoryName": null,
"ItemForceSalesTaxCodeId": null,
"ItemForceSalesTaxCodeName": null,
"ItemId": 96817,
"ItemIncomeAccountId": null,
"ItemIncomeAccountName": null,
"ItemNumber": "dropship-item-1",
"ItemSalesTaxProvinceMapList": null,
"ItemSubCategoryName": null,
"ItemTypeId": 10,
"ItemTypeName": "Inventory",
"ItemUpc": "",
"LineNumber": 1,
"LineTaxCalcCode": null,
"MatchFlag": false,
"ModifyDttm": null,
"ModifySource": null,
"Notes": null,
"OldBaseQtyShipped": null,
"OldQty": null,
"OldSellUomId": null,
"OldUomFactor": null,
"ProjectClassId": 3,
"ProjectClassName": null,
"Qty": 1,
"QtyDecimalFlag": true,
"QtyRemainingToCredit": 0,
"ReceiptId": null,
"ReceiptLineId": null,
"ReceiptNumber": null,
"ReceiptQty": null,
"RefId": null,
"RestrictionOverrideFlag": false,
"RestrictionOverridePrice": null,
"RestrictionOverrideUser": null,
"SellPkgQty": null,
"SellUomCode": "EA",
"SellUomId": 1,
"SellUomName": "Each",
"SoId": 157532,
"SoLineId": 199137,
"SoNumber": "LA01-S026054",
"StatusId": null,
"TaxAmount": null,
"TaxCategoryCode": "",
"TaxCodeId": null,
"TaxCodeName": "",
"TaxData": {
"taxItems": [],
"totalAmount": 0
},
"TaxDataJson": "{\r\n \"taxItems\": [],\r\n \"totalAmount\": 0.0\r\n}",
"TaxItems": null,
"TaxStateMappingProfileId": null,
"ThirdPartyRefNo": "",
"ThirdPartyRefNo2": null,
"ThirdPartySource": null,
"Title": null,
"TotalAmount": 42,
"TrackingBySerialNumberFlag": false,
"TxnId": "126AFD11BB030F47248E26464136",
"TxnNumber": 298933,
"TxnTypeId": null,
"UnitPrice": 42,
"UomFactor": 1,
"VASDiscountableFlag": true,
"VASItemCost": null,
"VASItemCostTotal": null,
"VASItemId": null,
"VASItemName": null,
"VASTaxableFlag": true
}
],
"invoiceItemSerialNumberArr": null,
"shipCartonArr": null
}
]
},
"IsForwardRequest": false,
"Message": "DropShip orders processed successfully.",
"MessageTitle": null,
"Result": true
}Last updated
Was this helpful?