Introduction
This page includes a list and definition of Complex Types used in the SOAP API environment of OneFlo. These complex types are used as
to the Web Service calls to OneFlo in order to elicit a response. The
may also be a complex type, especially when the expected response is an object with multiple attributes.
...
...
Guide:
Mandatory | Determine if the element is required when using this ComplexType. |
|
---|
| Element must be declared. |
|
| Element may be omitted. |
|
Direction | Determine when the element is used. |
|
---|
| Provided as both input |
/ and response from the Web Service |
|
| Only provided as a response from Web Service |
Useful for | Creating and releasing consignments |
---|
Used in | SaveConsignment |
---|
...
...
Anchor |
---|
| complextype_consignment |
---|
| complextype_consignment |
---|
|
Consignment
The Consignment object represents the data of the freight that is created in OneFlo. It contains information regarding the freight's account owner, distributor, sender, receiver, instructions, and line item details including whether the freight contains DG or not and other relevant information.
...
Element | Type | Mandatory / Optional | Length | Direction | Comments |
---|
AccountID | int | | - | | AccountID retrieved from Session. |
AllowConsolidation | bool | | - | | true/false : Indicates whether a consignment can be consolidated. If it's the first consignment for the day going to a receiver and service, a new consignment will be created. Succeeding consignments going to the same receiver and same service, the new items in this consignment will be appended to the previous consignment (that allows consolidation) and using the same connote number. This doesn't apply to consignments with Dangerous Goods. |
CloseAt | Time | | - | | hh:mm Time when the facilities will close (for pickup). Will be reflected on the Pickup Request and consignment data sent to carrier. |
ConsignmentDate | DateTime | | - | | Date of the creation of the consignment. |
|
|
|
|
|
|
ConsignmentID | long | | - | | ID of the record in the OneFlo database. Not required on creation. When updating an existing consignment, provide the ConsignmentID. |
ConsignmentItems | ConsignmentItem[] | | 1...n | | Details the items included in the consignment. |
ConsignmentNote | string | | 20 | | When provided, the consignment will be created with the provided Connote number. When not provided, OneFlo will generate a new connote number from the range. |
ConsignmentType | string | | - | | Not recommended for use. |
ConsolidatedSus | ConsolidateConsignment[] | | - | | Not recommended for use. |
ContainingConsignment | long | | - | | Not recommended for use. |
DeliveryInstructions | string | | 80 | | Delivery Instructions. Will appear on labels (depending on carrier specification may be limited in terms of number of characters due to real estate). |
Description | string | | 30 | | Description of Consignment. Won't appear on labels. |
DistributorID | int | | - | | DistributorID retrieved from Session. |
DownloadID | int | | - | | Not recommended for use. |
Exception | SaveException | | - | | Output. Provides detail on the result if there is an error with the data provided. |
Ext | ConsignmentsExt | | 0...1 | | Additional information for a consignment. |
ExtraInfo | string | | - | | Not recommended for use. |
Hours | float | | - | | Default 0. |
ModifiedBy | int | | - | | UserID as defined in the session. |
NoItems | short | | - | | Item Count Summary for the consignment. Computed from the data provided in ConsignmentItems. |
OnForwarder | int | | - | | Not required when Service is provided. |
PickupInstructions | string | | 80 | | Pickup Instructions. Will appear on Pickup request data when carrier is configured. |
ReadyAt | Time | | - | | hh:mm Time when the consignment is ready to be picked up. Will be reflected on Pickup Request and cosignment data sent to carrier. |
Receiver | Address | | 1 | | Details of the receiver of the freight. |
Reference | string | | 20 | | Stores the primary business reference (i.e. Sales Order Number, Pick Number, etc) |
References | Reference[] | | 0...n | | Additional References. |
Released | DateTime | | - | | Date of the release of the consignment, must be provided but will be updated by the system when the consignment is actually released via the Release*Consignment API. |
Sender | Address | | 1 | | Details of the sender of the freight. |
Service | string | | 10 | | Service for use. Must be a service defined in OneFlo as retrieved from the ShipperService Element of the ServicePricing. |
SessionID | long | | - | | Not recommended for use. |
SpecialInstructions | string | | 80 | | Additional Instructions. Will appear on labels (depending on carrier specification may be limited in terms of number of characters due to real estate). |
Volume | float | | - | | Total Consignment Volume in cubic metres. Computed from the data provided in ConsignmentItems. |
Weight | float | | - | | Total Consignment weight in kilograms. Computed from the data provided in ConsignmentItems. |
...
Example
...
...
...
...
Example
Code Block |
---|
language | xml |
---|
theme | RDark |
---|
linenumbers | true |
---|
|
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="http://www.opensys.com.au/ChainIT/4.0/ChainITDataServices">
<soapenv:Header/>
<soapenv:Body>
<SaveConsignment>
<session>
<AccountID>{{AccountID}}</AccountID>
Code Block |
---|
language | xml |
---|
theme | RDark |
---|
linenumbers | true |
---|
|
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="http://www.opensys.com.au/ChainIT/4.0/ChainITDataServices">
<soapenv:Header/>
<soapenv:Body>
<SaveConsignment>
<session>
<AccountID>{{AccountID}}</AccountID>
<DistributorID>{{DistributorID}}</DistributorID>
<Expires>{{Expires}}</Expires>
<Key>{{Key}}</Key>
<UserID>{{UserID}}</UserID>
</session>
<consignment>
<AccountID>{{AccountID}}</AccountID>
<AllowConsolidation>true</AllowConsolidation>
<CloseAt>16:00</CloseAt>
<ConsignmentDate>2018-08-02 10:09:00</ConsignmentDate>
<ConsignmentItems>
<ConsignmentItem>
<Description>SMALL CARTON NO DG</Description>
<Height>16</Height>
<ItemNo>1</ItemNo>
<Length>38</Length>
<NoItems>1</NoItems>
<Reference />
<Weight>5</Weight>
<Width>25</Width>
</ConsignmentItem>
<ConsignmentItem>
<ConsignmentProduct>
<Cubic>0.0152</Cubic>
<DangerousGoods>
<AggQty>4</AggQty>
<Class>2.1</Class>
<Group>NONE</Group>
<Name>AEROSOLS</Name>
<PSN>AEROSOLS IN A CAN</PSN>
<Qty>1</Qty>
<Receptacle>CAN</Receptacle>
<SubRisk>N/A</SubRisk>
<UnCode>1950</UnCode>
<Units>kg</Units>
</DangerousGoods>
</ConsignmentProduct>
<Description>SMALL CARTON WITH DG</Description>
<Height>16</Height>
<ItemNo>1</ItemNo>
<Length>38</Length>
<NoItems>1</NoItems>
<Reference />
<Weight>5</Weight>
<Width>20</Width>
</ConsignmentItem>
</ConsignmentItems>
<DeliveryInstructions>Deliver to Front Door.</DeliveryInstructions>
<Description />
<DistributorID>{{DistributorID}}</DistributorID>
<ReadyAt>14:00</ReadyAt>
<Receiver>
<AddressLocation>
<CountryCode>AU</CountryCode>
<SuburbStatePostcode>HALLAM VIC 3803</SuburbStatePostcode>
</AddressLocation>
<ATL>true</ATL>
<Contact>CONTACT PERSON</Contact>
<Country>AUSTRALIA</Country>
<CountryCode>AU</CountryCode>
<Email>hallam@company.com.au</Email>
<Line1>89 Wellington Street</Line1>
<Line2 />
<Line3 />
<Name>CUSTOMER ABC</Name>
<Phone>03 1234 1000</Phone>
</Receiver>
<Reference>PO123456</Reference>
<Released>2019-08-01T00:00:00</Released>
<Sender>
<AddressLocation>
<CountryCode>AU</CountryCode>
<SuburbStatePostcode>SCORESBY VIC 3179</SuburbStatePostcode>
</AddressLocation>
<Country>AUSTRALIA</Country>
<CountryCode>AU</CountryCode>
<Line1>7 Lakeview Drive</Line1>
<Line2 />
<Line3 />
<Name>SENDER ENTITY</Name>
<Phone />
</Sender>
<Service>STEEXP</Service>
<SpecialInstructions/>
</consignment>
</SaveConsignment>
</soapenv:Body>
</soapenv:Envelope> |
...
Anchor |
---|
| complextype_consignmentitems |
---|
| complextype_consignmentitems |
---|
|
Consignment Item
Type | |
---|
Useful for | Creating and releasing consignment items within consignments |
---|
Used in | SaveConsignment / GetChargeQuote |
---|
The Consignment Item otherwise known as a shipping unit / item is an object represents the data of the freight items created within a Consignment object that is created in OneFlo. A consignment must contain at least one consignment item. This is the actual object that will be labeled and will travel with the carrier. Each object defines what gets printed in the label.
XSD
Code Block |
---|
language | xml |
---|
theme | RDark |
---|
title | Consignment |
---|
|
<xs:complexType name="ConsignmentItem">
<xs:sequence>
<xs:element minOccurs="0" name="Barcode" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="ConsignmentID" type="xs:long"/>
<xs:element minOccurs="0" name="ConsignmentProduct" nillable="true" type="tns:Product"/>
<xs:element minOccurs="0" name="Description" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="ExchangeReturnable" type="xs:boolean"/>
<xs:element minOccurs="0" name="Height" type="xs:float"/>
<xs:element minOccurs="0" name="ItemNo" type="xs:int"/>
<xs:element minOccurs="0" name="ItemType" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="Length" type="xs:float"/>
<xs:element minOccurs="0" name="ModifiedBy" type="xs:int"/>
<xs:element minOccurs="0" name="NoItems" type="xs:int"/>
<xs:element minOccurs="0" name="PackagingType" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="Palletised" type="xs:boolean"/>
<xs:element minOccurs="0" name="ProductID" type="xs:int"/>
<xs:element minOccurs="0" name="Reference" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="Returnable" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="Volume" type="xs:float"/>
<xs:element minOccurs="0" name="Weight" type="xs:float"/>
<xs:element minOccurs="0" name="Width" type="xs:float"/>
</xs:sequence>
</xs:complexType>
<xs:element name="ConsignmentItem" nillable="true" type="tns:ConsignmentItem"/> |
Elements
Element | Type | Mandatory / Optional | Length | Direction | Comments |
---|
Barcode | string | | - | | This is the SSCC barcode. If no SSCC is provided, OneFlo will generate a barcode for you. |
ConsignmentID | long | | - | | ID of the record in the OneFlo database. Not required on creation. When updating an existing consignment, provide the ConsignmentID. |
ConsignmentProduct | Product | | - | | This is a complex type for the definition of Dangerous Goods. |
Description | string | | 40 | | A description of the goods being shipped. |
ExchangeReturnable | boolean | | - | |
|
Height | float | | - | | Height of item in centimetres (cm). |
ItemNo | int | | - | | The index (starting 1) or otherwise known as ordinal integer. e.g. if there are 3 packages, this will enumerate package 1, package 2, and package 3 |
ItemType | string | | 20 | | Item Code - could be your warehouse Shipping Unit code (i.e. Carton_12X or CHEP_Pallet) |
Length | float | | - | | Length of item in centimetres (cm). |
ModifiedBy | int | | - | |
|
NoItems | int | | 1... | | Total Number of SUs for the consignment. Must be a positive integer. Ideally when enumerating items, this must have a value of '1'. |
PackagingType | string | | 20 | | Should be one of the available packaging types in OneFlo. Shipping Items - Packaging Type. |
Palletised | boolean | | - | | Non-mandatory, please see Packaging Type. |
ProductID | int | | - | |
|
Reference | string | | 20 | | Item Reference associated to the order. This is useful for consolidated items where items need to be identified into which particular order it's under. This can also be used to indicate specifically which references are associated to the shipping unit. |
Returnable | string | | 20 | |
|
Volume | float | | - | | Cubic metres (m3). Up to 3 decimal places. |
Weight | float | | - | | Weight of the item in kilograms (kg). |
Width | float | | - | | Width of item in centimetres (cm). |
...
Anchor |
---|
| complextype_anchor |
---|
| complextype_anchor |
---|
|
Address
...
The address field defines the structure of the address entity in the OneFlo database. This address entity is used as components of the Consignment element via its Sender and Receiver elements.
XSD
Code Block |
---|
|
<xs:complexType name="Address">
<xs:sequence>https://www.youtube.com/watch?v=bbStdHPMMf4
<xs:element minOccurs="0" name="AccountID" type="xs:int"/>
<xs:element minOccurs="0" name="AddressID" type="xs:int"/>
<xs:element minOccurs="0" name="AddressLocation" nillable="true" type="tns:Location"/>
<xs:element minOccurs="0" name="ContactName" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="Email" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="Exception" nillable="true" type="tns:SaveException"/>
<xs:element minOccurs="0" name="Fax" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="Line1" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="Line2" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="Line3" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="LocationDetails" nillable="true" type="tns:Location"/>
<xs:element minOccurs="0" name="LocationID" type="xs:int"/>
<xs:element minOccurs="0" name="ModifiedBy" type="xs:int"/>
<xs:element minOccurs="0" name="Name" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="Phone" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="State" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="Suburb" nillable="true" type="xs:string"/>
</xs:sequence>
</xs:complexType>
<xs:element name="Address" nillable="true" type="tns:Address"/> |
Elements
Element | Type | Mandatory / Optional | Length | Comments |
---|
AccountID | int | | - | Owner of this address entity in the OneFlo database. |
AddressID | int | | - | The record ID of this address entity. |
Name | string | | 50 | Entity or Company name. Could be the name of the person receiving the freight. |
Line1 | string | | 30 | First line of the address. Must be provided so it appears on the label + postback. |
Line2 | string | | 30 | Additional line, when required. Will appear on label + postback. |
Line3 | string | | 30 | Extra line. Most carrier labels don't render this. |
LocationID | int | | - | LocationID in the OneFlo database. LocationID can be retrieved from the ValidateLocation API. BEST PRACTICE: If known and provided, no need to define the AddressLocation and LocationDetails of this Address and providing this is more accurate than using AddressLocation or LocationDetails |
ContactName | string | | 20 | Name of person / contact for this address entity. Will appear on label. |
Phone | string | | 15 | Phone number of contact. Will appear on Label. |
Email | string | | 50 | Email address of contact. When populated in Consignment.Receiver, this will be used to deliver ASNs. |
Fax | string | | 15 |
|
AddressLocation | Location | | 0...1 | No need to define this element if the LocationID or LocationDetails element is provided. |
LocationDetails | Location | | 0...1 | No need to define this element if the LocationID or AddressLocation element is provided. |
ModifiedBy | int | | - | UserID as defined in the session. |
State | string | | 5 | Not recommended for use. |
Suburb | string | | 50 | Not recommended for use. |
Exception | SaveException | | - | Output. Provides detail on the result if there is an error with the data provided. |
...
Service pricing is the result of a quote request. This defines the available services given a quoted freight profile. Please refer to the GetChargeQuote* API calls
XSD
Code Block |
---|
|
<xs:complexType name="ServicePricing">
<xs:sequence>
<xs:element minOccurs="0" name="CalculatedSUType" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="CarrierID" type="xs:int"/>
<xs:element minOccurs="0" name="CarrierName" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="CarrierService" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="ETA" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="FeesCharge" type="xs:decimal"/>
<xs:element minOccurs="0" name="FreightCharge" type="xs:decimal"/>
<xs:element minOccurs="0" name="ID" type="xs:int"/>
<xs:element minOccurs="0" name="NetCharge" type="xs:decimal"/>
<xs:element minOccurs="0" name="RateID" type="xs:int"/>
<xs:element minOccurs="0" name="ServiceName" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="ShipperService" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="TaxCharge" type="xs:decimal"/>
<xs:element minOccurs="0" name="TotalCharge" type="xs:decimal"/>
<xs:element minOccurs="0" name="WebDescription" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="ZoneFrom" nillable="true" type="xs:string"/>
<xs:element minOccurs="0" name="ZoneTo" nillable="true" type="xs:string"/>
</xs:sequence>
</xs:complexType>
<xs:element name="ServicePricing" nillable="true" type="tns:ServicePricing"/> |
Elements
Element | Type | Mandatory / Optional | Length | Comments |
---|
CalculatedSUType | string | - | - | If the rate in the system is calculated against a Shipping Unit type, this is represented as a CalculatedSUType. |
CarrierID | int | - | - | ID of the carrier in OneFlo. |
CarrierName | string | - | - | Full name of the carrier in OneFlo. |
CarrierService | string | - | - | Carrier side service |
ETA | string | - | - | Estimated Delivery Date as provided by the carrier for the lane. OneFlo must have this information before it's provided. |
FeesCharge | decimal | - | - | Freight Fees |
FreightCharge | decimal | - | - | Freight charge |
ID | int | - | - | Not used. |
NetCharge | decimal | - | - | Net freight charge |
RateID | int | - | - | OneFlo Rate ID |
ServiceName | stirng | - | - | OneFlo full service name. |
ShipperService | string | - | - | OneFlo carrier service code. This is the code to be provided as a Service when creating/modifying the Consignment object. |
TaxCharge | decimal | - | - | GST |
TotalCharge | decimal | - | - | NetCharge + GST |
WebDescription | string | - | - | OneFlo Service Description |
ZoneFrom | string | - | - | OneFlo carrier Zone source |
ZoneTo | string | - | - | OneFlo carrier Zone destination |
...