2330 Order Status (API)

Overview

The purpose of this service is to provide the live order status for a given warehouse reference

All stock orders will show an order status however there are three key types

  • Transfer order which is considered complete when the transfer takes place

  • Collection from warehouse which is considered complete when an order is collected

  • Deliveries by the warehouse which is considered complete when the order is pick confirmed.

If you are looking to confirm orders for invoicing you should look at the order pick confirmation which is a consistent point (also the duty point) for the order as the status not definitive and can be rolled back.

Service Name

2330OS

 

Limitations

Fields from MST onwards are only available if the warehouse are performing the delivery for any collections this information will be missing as they will not be known

2330 - will display all orders which have not been marked as despatched/collected, and if completed then will remain on the output for no more than 7 days.

2331 - you can request the status of any order irrespective of status

 

Last Updates

We will only show entries highlighting changes which are less than 2 years old

Date

Change

 

 

 

 

Input Parameters

Parameter

Details

Required

Parameter

Details

Required

CustCode

Customer Code

Mandatory

SiteCode

Site Code

Mandatory

DocRef

Document Reference

Mandatory

Get Example

http://<pathtoapi>/service/2330OS/CustCode/ABC123/SiteCode/RR/DocRef/123456

 

Response Codes

Common response codes

Code

Message

Code

Message

200

Order found and response prepared successfully.

204

No order found for the parameters provided.

Response Example

Sample

<T>        <R>             <CCO>ABC123</CCO>             <SCO>ZZ</SiteCode>             <DRF>SO123456789</DRF>             <ORH>912345678</ORH>             <SPH>812345679</SPH>             <PCF>true</PCF>             <STS>PICK COMPLETE</STS> <DM>CARR</DM> <PCNO>2313164646984</PCNO> <PCDD>25/07/2024</PCDD> <COK>YES</COK> <CCO>DPD LOCAL</CCO>        </R> </T>

XML Element Details

XML Segment

XML API Element

Length

Notes

<T>

<R>

 

 

Will repeat for each order

 

<CCO>

 

Customer code - Your warehouse account reference

 

<SCO>

 

Site code - The site code where your account is based at the warehouse

 

<DRF>

 

Document reference - Your reference for the order

 

<ORH>

 

Order UID - The warehouse reference for your order

 

<SPH>

 

Pick UID - The warehouse pick reference for the order

 

<PCF>

 

Pick confirmed - Have the warehouse finished the pick?

 

<STS>

 

Cancelled
Held by VCIS user
User held
System held
Awaiting approval
Pre-pick planning
Awaiting pick
Pick planned
Pick prepared
eFulfillment Pick Prepared
Pick complete
Awaiting Despatch
Collected or despatched

 

<DM>

 

Delivery Method

  • Warehouse arranged

  • Collection from warehouse

  • Connected Parcel Carrier

 

<PCNO>

 

Parcel Carrier Consignment No

 

<PCDD>

 

Parcel Carrier despatch date

 

<COK>

 

Ready for Collection

 

<CCO>

 

Collection Company

</R>

 

 

 

</T>

 

Copyright Ontech Solutions 2017-2024. All rights reserved, no part may be replicated or distributed without the express permission of the owner.