Table of Contents

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

Status

colour	Green
title	input

to the Web Service calls to OneFlo in order to elicit a response. The

Status

colour	Blue
title	response

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.

Status

colour	Red
title	M

Element must be declared.

Status

title	O

Element may be omitted.

Direction

Determine when the element is used.

Status

title

colour	Green

input

BOTH

Provided as both input and response from the Web Service

Status

colour	Blue
title	OUTPUT

Only provided as a response

Useful forCreating and releasing consignmentsUsed inSaveConsignment

...

from Web Service

...

Anchor
complextype_consignment
complextype_consignment
Consignment

Type

Status

colour	Green
title	input

/

Status

colour	Blue
title	response

Useful for

Creating and releasing consignments

Used in

SaveConsignment

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.

XSD

Code Block

language	xml
theme	RDark
title	Consignment

<xs:complexType name="Consignment">
	<xs:sequence>
		<xs:element minOccurs="0" name="AccountID" type="xs:int"/>
		<xs:element minOccurs="0" name="AllowConsolidation" type="xs:boolean"/>
		<xs:element minOccurs="0" name="CloseAt" nillable="true" type="xs:string"/>
		<xs:element minOccurs="0" name="ConsignmentDate" nillable="true" type="xs:string"/>
		<xs:element minOccurs="0" name="ConsignmentID" type="xs:long"/>
		<xs:element minOccurs="0" name="ConsignmentItems" nillable="true" type="tns:ArrayOfConsignmentItem"/>
		<xs:element minOccurs="0" name="ConsignmentNote" nillable="true" type="xs:string"/>
		<xs:element minOccurs="0" name="ConsignmentType" nillable="true" type="xs:string"/>
		<xs:element minOccurs="0" name="ConsolidatedSus" nillable="true" type="tns:ArrayOfConsolidateConsignment"/>
		<xs:element minOccurs="0" name="ContainingConsignment" type="xs:long"/>
		<xs:element minOccurs="0" name="DeliveryInstructions" nillable="true" type="xs:string"/>
		<xs:element minOccurs="0" name="Description" nillable="true" type="xs:string"/>
		<xs:element minOccurs="0" name="DistributorID" type="xs:int"/>
		<xs:element minOccurs="0" name="DownloadID" type="xs:int"/>
		<xs:element minOccurs="0" name="Exception" nillable="true" type="tns:SaveException"/>
		<xs:element minOccurs="0" name="Ext" nillable="true" type="tns:ConsignmentExt"/>
		<xs:element minOccurs="0" name="ExtraInfo" nillable="true" type="xs:string"/>
		<xs:element minOccurs="0" name="Hours" type="xs:float"/>
		<xs:element minOccurs="0" name="ModifiedBy" type="xs:int"/>
		<xs:element minOccurs="0" name="NoItems" type="xs:short"/>
		<xs:element minOccurs="0" name="OnForwarder" type="xs:int"/>
		<xs:element minOccurs="0" name="PickupInstructions" nillable="true" type="xs:string"/>
		<xs:element minOccurs="0" name="ReadyAt" nillable="true" type="xs:string"/>
		<xs:element minOccurs="0" name="Receiver" nillable="true" type="tns:Address"/>
		<xs:element minOccurs="0" name="Reference" nillable="true" type="xs:string"/>
		<xs:element minOccurs="0" name="References" nillable="true" type="tns:ArrayOfReference"/>
		<xs:element minOccurs="0" name="Released" nillable="true" type="xs:string"/>
		<xs:element minOccurs="0" name="Sender" nillable="true" type="tns:Address"/>
		<xs:element minOccurs="0" name="Service" nillable="true" type="xs:string"/>
		<xs:element minOccurs="0" name="SessionID" type="xs:long"/>
		<xs:element minOccurs="0" name="SpecialInstructions" nillable="true" type="xs:string"/>
		<xs:element minOccurs="0" name="Volume" type="xs:float"/>
		<xs:element minOccurs="0" name="Weight" type="xs:float"/>
	</xs:sequence>
</xs:complexType>
<xs:element name="Consignment" nillable="true" type="tns:Consignment"/>

Elements

Element

Type

Mandatory / Optional

Length

Direction

Comments

AccountID

int

Status

colour	Red
title	M

-

Status


colour	Green
title	BOTH

AccountID retrieved from Session.

CloseAt

AllowConsolidation

TimeConsignmentDateDateTime

bool

Status

colour	Red
title	M

-

Status


colour	Green
title	BOTH

hh:mm

Time when the facilities will close (for pickup). Will be reflected on the Pickup Request and consignment data sent to carrier.

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

Status

colour	Red
title	M

-

Status


colour	Green
title	BOTH

Date of the creation of the consignment.ConsignmentTypestring StatustitleO

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

Status

colour	Red
title	M

-

Status

colour

BlueNot recommended for use

title
Green

OUTPUT

BOTH

Date of the creation of the consignment.

ConsignmentID

long

Status

title	O

-

Status


colour	Green
title	BOTH

ID of the record in the OneFlo database.

Not required on creation.

When updating an existing consignment, provide the ConsignmentID.

ConsignmentItems

ConsignmentItem[]

Status

colour	Red
title	M

1...n

Status


colour	Green
title	BOTH

Details the items included in the consignment.

ConsignmentNote

string

Status

title	O

20

Status


colour	Green
title	BOTH

When provided, the consignment will be created with the provided Connote number.

When not provided, OneFlo will generate a new connote number

form

from the range.

ConsolidatedSus

ConsignmentType

ConsolidateConsignment[]

string

Status

title	O

-

Status

colour

BlueContainingConsignmentlong Status

title
Green

OUTPUTNot recommended for use.

BOTH

Indicates the consignment movement:

Populate with "Pickup" for Outbound; "Return" for returns; and, "Transfer" for transfers.

ConsolidatedSus

ConsolidateConsignment[]

Status

title	O

-

Status

colour	Blue
title	OUTPUT

Not recommended for use.

ContainingConsignment

long

Status

title	O

-

Status

colour	Blue
title	OUTPUT

Not recommended for use.

DeliveryInstructions

string

Status

title	O

80

Status


colour	Green
title	BOTH

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

Status

title	O

30

Status


colour	Green
title	BOTH

Description of Consignment. Won't appear on labels.

DistributorID

int

Status

colour	Red
title	M

-

Status


colour	Green
title	BOTH

DistributorID retrieved from Session.

DownloadID

int

Status

title	O

-

Status

colour	Blue
title	OUTPUT

Not recommended for use.

Exception

SaveException

Status

title	O

-

Status

colour	Blue
title	OUTPUT

Output. Provides detail on the result if there is an error with the data provided.

Ext

ConsignmentsExt

Status

title	O

0...1

Status


colour	Green
title	BOTH

Additional information for a consignment.

ExtraInfo

string

Status

title	O

-

Status

colour	Blue
title	OUTPUT

Not recommended for use.

Hours

float

Status

title	O

-

Status


colour	Green
title	BOTH

Default 0.

ModifiedBy

int

Status

colour	Red
title	M

-

Status


colour	Green
title	BOTH

UserID as defined in the session.

NoItems

short

Status

title	O

-

Status

colour	Blue
title	OUTPUT

Item Count Summary for the consignment. Computed from the data provided in ConsignmentItems.

OnForwarder

int

Status

title	O

-

Status


colour	Green
title	BOTH

Not required when Service is provided.

PickupInstructions

string

Status

title	O

80

Status


colour	Green
title	BOTH

Pickup Instructions. Will appear on Pickup request data when carrier is configured.

ReadyAt

Time

Status

colour	Red
title	M

-

Status


colour	Green
title	BOTH

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

Status

colour	Red
title	M

1

Status


colour	Green
title	BOTH

Details of the receiver of the freight.

Reference

string

Status

title	O

20

Status


colour	Green
title	BOTH

Stores the primary business reference (i.e. Sales Order Number, Pick Number, etc)

References

Reference[]

Status

title	O

0...n

Status


colour	Green
title	BOTH

Additional References.

Released

DateTime

Status

colour	Red
title	M

-

Status


colour	Green
title	BOTH

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

Status

colour	Red
title	M

1

Status


colour	Green
title	BOTH

Details of the sender of the freight.

Service

string

Status

colour	Red
title	M

10

Status


colour	Green
title	BOTH

Service for use. Must be a service defined in OneFlo as retrieved from the ShipperService Element of the ServicePricing.

SessionID

long

Status

title	O

-

Status

colour	Blue
title	OUTPUT

Not recommended for use.

SpecialInstructions

string

Status

title	O

80

Status


colour	Green
title	BOTH

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

Status

title	O

-

Status

colour	Blue
title	OUTPUT

Total Consignment Volume in cubic metres. Computed from the data provided in ConsignmentItems.

Weight

float

Status

title	O

-

Status

colour	Blue
title	OUTPUT

Total Consignment weight in kilograms. Computed from the data provided in ConsignmentItems.

...

Example

...

Status

colour	Red
title	M

...

Status

title	O

...

Status

colour	Blue
title	OUTPUT

...

Example

<soapenv:Envelope xmlns

Code Block

language	xml
theme	RDark
linenumbers	true

Code Block

language	xml
theme	RDark
linenumbers	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"  xmlns:cha="http://www.opensys.com.au/ChainIT/4.0/ChainITDataServices">
	<soapenv:Header/>
	<soapenv:Body>
		<cha:SaveConsignment><SaveConsignment>
			<cha:session><session>
				<cha:AccountID>115860</cha:<AccountID>{{AccountID}}</AccountID>
				<cha:DistributorID>101605</cha:<DistributorID>{{DistributorID}}</DistributorID>
				<cha:Expires>2018-09-18T15:30:14.923</cha:<Expires>{{Expires}}</Expires>
				<cha:Key>3A1D47BB-40F7-4C71-ADAC-0689A298576B</cha:<Key>{{Key}}</Key>
				<cha:UserID>64796</cha:<UserID>{{UserID}}</UserID>
			</cha:session>session>
			<cha:consignment><consignment>
				<cha:AccountID>115860</cha:AccountID><AccountID>{{AccountID}}</AccountID>
				<AllowConsolidation>true</AllowConsolidation>
				<cha<CloseAt>16:CloseAt>16:00</cha:CloseAt>
				<cha:ConsignmentDate>2018<ConsignmentDate>2018-0908-18T1602 10:0009:00</cha:ConsignmentDate>
				<cha:ConsignmentID>0</cha:ConsignmentID>
<ConsignmentItems>
					<cha:ConsignmentItems><ConsignmentItem>
					<!--Zero or more repetitions:-->	<Description>SMALL CARTON NO DG</Description>
					<cha:ConsignmentItem>
		<Height>16</Height>           
						<cha:Barcode>QRX11236-001</cha:Barcode> <!--unique item code linked to connote as printed on label --><ItemNo>1</ItemNo>             
						<cha:ConsignmentID>0</cha:ConsignmentID><Length>38</Length>
						<cha:Description>QRX11236</cha:Description><NoItems>1</NoItems>
						<cha:Height>100</cha:Height><Reference />
						<cha:ItemNo>1</cha:ItemNo><Weight>5</Weight>
						<cha:ItemType>CARTON</cha:ItemType><Width>25</Width>
						<cha:Length>100</cha:Length></ConsignmentItem>
					<ConsignmentItem>
						<cha:NoItems>1</cha:NoItems><ConsignmentProduct>
						<cha:Volume>0.001</cha:Volume>	<Cubic>0.0152</Cubic>
						<cha:Weight>5</cha:Weight>	<DangerousGoods>
						<cha:Width>100</cha:Width>		<AggQty>4</AggQty>
					</cha:ConsignmentItem>
				</cha:ConsignmentItems><Class>2.1</Class>
				<cha:ConsignmentNote>QRX11236</cha:ConsignmentNote>
				<cha:ConsignmentType<Group>NONE</>Group>
					<cha:ConsolidatedSus>
		               <cha:ConsolidateConsignment>
		                  <cha:Height>10</cha:Height>
		                  <cha:ItemType>CARTON</cha:ItemType>
		          	<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>        <cha:Items>2</cha:Items>   
						<ItemNo>1</ItemNo>             
    <cha:Length>10</cha:Length>
		                  <cha:Volume>10</cha:Volume>
		                  <cha:Weight>15</cha:Weight>
		                  <cha:Width>20</cha:Width>
		               </cha:ConsolidateConsignment>
		            </cha:ConsolidatedSus>
				<cha:ContainingConsignment>0</cha:ContainingConsignment>
				<cha:DeliveryInstructions>TEST DEL</cha:DeliveryInstructions>
				<cha:Description>Description</cha:Description>
				<cha:DistributorID>101605</cha:DistributorID>
				<cha:DownloadID>0</cha:DownloadID>

				<cha:Ext>
					<cha:ConsignmentID>0</cha:ConsignmentID>
					<cha:CostCenter/>
					<cha:ThirdPartyAccount/>
					<cha:UserField1						<Length>38</Length>
						<NoItems>1</NoItems>
						<PackagingType>SAT</PackagingType>
						<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 />
					<cha:UserField2<Line3 />
					<cha:UserField3/><Name>SENDER ENTITY</Name>
					<cha:UserField4<Phone />
					<cha:UserField5/></Sender>
				<<Service>STEEXP</cha:Ext>Service>
				<cha:ExtraInfo<SpecialInstructions/>
				<cha:Hours>0</cha:Hours></consignment>
				<cha:ModifiedBy>64796</cha:ModifiedBy>
				<cha:NoItems>1</cha:NoItems>
				<cha:OnForwarder>102261</cha:OnForwarder>
				<cha:PickupInstructions>Test PICK</cha:PickupInstructions>
				
				<cha:ReadyAt>13:00</cha:ReadyAt>
				<cha:Receiver>
					<cha:AccountID>115860</cha:AccountID>
					<cha:AddressID>0</cha:AddressID>
					<cha:AddressLocation>
						<cha:LocationID>0</cha:LocationID>
						<cha:Locality>MELBOURNE</cha:Locality>
						<cha:State>VIC</cha:State>
						<cha:Postcode>3000</cha:Postcode>
						<cha:CountryCode>AU</cha:CountryCode>
						<cha:SuburbStatePostcode>MELBOURNE VIC 3000</cha:SuburbStatePostcode>
					</cha:AddressLocation>
					<cha:Line1>123 Test ST</cha:Line1>
					<cha:Line2/>
					<cha:LocationID>0</cha:LocationID>
					<cha:ModifiedBy>64796</cha:ModifiedBy>
					<cha:ContactName>Dennis</cha:ContactName>
					<cha:Email>dennis@efmlogistics.com.au</cha:Email>
					<cha:Name>HELLO WORLD</cha:Name>
					<cha:Phone>01000000</cha:Phone>

				</cha:Receiver>
				
				<cha:Reference>123456</cha:Reference>
				<cha:References>
					<!--Zero or more repetitions:-->
					<cha:Reference>
						<cha:ConsignmentReference/>
						<cha:RemoveReference>0</cha:RemoveReference>
					</cha:Reference>
				</cha:References>
				<cha:Released>2018-09-05T16:10:00</cha:Released>
				<cha:Sender>
		               <cha:AccountID>115860</cha:AccountID>
		               <cha:AddressID>0</cha:AddressID>
		               <cha:AddressLocation>
		                  <cha:LocationID>0</cha:LocationID>
		                  <cha:Locality>GLEN WAVERLEY</cha:Locality>
		                  <cha:State>VIC</cha:State>
		                  <cha:Postcode>3150</cha:Postcode>
		                  <cha:CountryCode>AU</cha:CountryCode>
		                  <cha:SuburbStatePostcode>GLEN WAVERLEY VIC 3150</cha:SuburbStatePostcode>
		               </cha:AddressLocation>
		               <cha:ContactName>test, user</cha:ContactName>
		               <cha:Email>ed@efm.com</cha:Email>
		               <cha:Line1>c/ EFM</cha:Line1>
		               <cha:Line2></cha:Line2>

		               <cha:LocationID>0</cha:LocationID>
		               <cha:ModifiedBy>64796</cha:ModifiedBy>
		               <cha:Name>OneFlo</cha:Name>
		               <cha:Phone>000000000</cha:Phone>
		               <cha:State>VIC</cha:State>
		               <cha:Suburb>GLEN WAVERLEY</cha:Suburb>
		            </cha:Sender>
		            
				<cha:Service>NPG</cha:Service>
				<cha:SessionID>0</cha:SessionID>
				<cha:SpecialInstructions>TEST SPE</cha:SpecialInstructions>
				<cha:Volume>0.001</cha:Volume>
				<cha:Weight>1</cha:Weight>
			</cha:consignment>
		</cha:SaveConsignment>
	</soapenv:Body>
</soapenv:Envelope>

...

</SaveConsignment>
	</soapenv:Body>
</soapenv:Envelope>

...

Anchor
consignmentitems
consignmentitems
Consignment Item

Type

Status

colour	Green
title	input

/

Status

colour	Blue
title	response

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

Status

title	O

-

Status


colour	Green
title	BOTH

This is the SSCC barcode. If no SSCC is provided, OneFlo will generate a barcode for you.

ConsignmentID

long

Status

title	O

-

Status


colour	Green
title	BOTH

ID of the record in the OneFlo database.

Not required on creation.

When updating an existing consignment, provide the ConsignmentID.

ConsignmentProduct

Product

Status

title	O

-

Status


colour	Green
title	BOTH

This is a complex type for the definition of Dangerous Goods.

Description

string

Status

title	O

40

Status


colour	Green
title	BOTH

A description of the goods being shipped.

ExchangeReturnable

boolean

Status

title	O

-

Status

colour	Blue
title	OUTPUT

Height

float

Status

colour	Red
title	M

-

Status


colour	Green
title	BOTH

Height of item in centimetres (cm).

ItemNo

int

Status

title	O

-

Status


colour	Green
title	BOTH

The index (starting 1) or otherwise known as ordinal integer. It's not mandatory to provide this because OneFlo will assign it upon saving.

e.g. if there are 3 packages, this will enumerate package 1, package 2, and package 3

ItemType

string

Status

colour	Red
title	M

20

Status


colour	Green
title	BOTH

Item Code - could be your warehouse Shipping Unit code (i.e. Carton_12X or CHEP_Pallet)

Length

float

Status

colour	Red
title	M

-

Status


colour	Green
title	BOTH

Length of item in centimetres (cm).

ModifiedBy

int

Status

title	O

-

Status

colour	Blue
title	OUTPUT

NoItems

int

Status

colour	Red
title	M

1

Status


colour	Green
title	BOTH

Because the representation of each item must be declared in a ConsignmentItem element, this field must always have the value of '1'.

Multiple items of the same type must be declared in separate ConsignmentItem elements.

PackagingType

string

Status

colour	Red
title	M

20

Status


colour	Green
title	BOTH

Should be one of the available packaging types in OneFlo. Shipping Items - Packaging Type.

Palletised

boolean

Status

title	O

-

Status


colour	Green
title	BOTH

Non-mandatory, please see Packaging Type.

ProductID

int

Status

title	O

-

Status


colour	Green
title	BOTH

Reference

string

Status

title	O

20

Status


colour	Green
title	BOTH

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

Status

title	O

20

Status


colour	Green
title	BOTH

Volume

float

Status

colour	Red
title	M

-

Status


colour	Green
title	BOTH

Cubic metres (m³). Up to 3 decimal places.

Weight

float

Status

colour	Red
title	M

-

Status


colour	Green
title	BOTH

Weight of the item in kilograms (kg).

Width

float

Status

colour	Red
title	M

-

Status


colour	Green
title	BOTH

Width of item in centimetres (cm).

...

Anchor
cp_address
cp_address
Address

Type

Status

colour	Green
title	input

/

Status

colour	Blue
title	response

Useful for

Creating and releasing consignments

Used in

SaveConsignment

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

<xs:complexType name="Address"> <xs:sequence>https://www.youtube.com/watch?v=bbStdHPMMf4

Code Block

language	xml
theme	RDark

	RDark

<xs:complexType name="Address">
	<xs:sequence>
		<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="ATL" type="xs:boolean"/>
		<xs:element minOccurs="0" name="AccountIDContactName" nillable="true" type="xs:intstring"/>
		<xs:element minOccurs="0" name="AddressIDEmail" nillable="true" type="xs:intstring"/>
		<xs:element minOccurs="0" name="AddressLocationException" nillable="true" type="tns:LocationSaveException"/>
		<xs:element minOccurs="0" name="ContactNameFax" nillable="true" type="xs:string"/>
		<xs:element minOccurs="0" name="EmailLine1" nillable="true" type="xs:string"/>
		<xs:element minOccurs="0" name="ExceptionLine2" nillable="true" type="tnsxs:SaveExceptionstring"/>
		<xs:element minOccurs="0" name="FaxLine3" nillable="true" type="xs:string"/>
		<xs:element minOccurs="0" name="Line1LocationDetails" nillable="true" type="xstns:stringLocation"/>
		<xs:element minOccurs="0" name="Line2LocationID" nillable="true" type="xs:stringint"/>
		<xs:element minOccurs="0" name="Line3" nillable="true"ModifiedBy" type="xs:stringint"/>
		<xs:element minOccurs="0" name="LocationDetailsName" nillable="true" type="tnsxs:Locationstring"/>
		<xs:element minOccurs="0" name="LocationID"Phone" nillable="true" type="xs:intstring"/>
		<xs:element minOccurs="0" name="ModifiedBy"State" nillable="true" type="xs:intstring"/>
		<xs:element minOccurs="0" name="NameSuburb" nillable="true" type="xs:string"/>
		<xs:element minOccurs="0"</xs:sequence>
</xs:complexType>
<xs:element name="PhoneAddress" nillable="true" type="xstns: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

...

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

...

Address"/>

Elements

Element

Type

Mandatory / Optional

Length

Comments

AccountID

int

Status

colour	Red
title	M

-

Owner of this address entity in the OneFlo database.

AddressID

int

Status

title	O

-

The record ID of this address entity.

ATL

bool

Status

title	O

-

1/0 : Indicates if the receiver allows ATL (Authority to Leave), when a carrier is allowed to leave the parcel/freight without signature.

Name

string

Status

colour	Red
title	M

50

Entity or Company name. Could be the name of the person receiving the freight.

Line1

string

Status

colour	Red
title	M

30

First line of the address. Must be provided so it appears on the label + postback.

Line2

string

Status

title	O

30

Additional line, when required. Will appear on label + postback.

Line3

string

Status

title	O

30

Extra line. Most carrier labels don't render this.

LocationID

int

Status

colour	Red
title	M

-

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

Status

colour	Red
title	M

20

Name of person / contact for this address entity. Will appear on label.

Phone

string

Status

title	O

15

Phone number of contact. Will appear on Label.

Email

string

Status

title	O

50

Email address of contact. When populated in Consignment.Receiver, this will be used to deliver ASNs.

Fax

string

Status

title	O

15

AddressLocation

Location

Status

title	O

0...1

No need to define this element if the LocationID or LocationDetails element is provided.

LocationDetails

Location

Status

title	O

0...1

No need to define this element if the LocationID or AddressLocation element is provided.

ModifiedBy

int

Status

colour	Red
title	M

-

UserID as defined in the session.

State

string

Status

title	O

5

Not recommended for use.

Suburb

string

Status

title	O

50

Not recommended for use.

Exception

SaveException

Status

title	O

-

Output. Provides detail on the result if there is an error with the data provided.

Legend:

Mandatory

Determine if the element is required when using this ComplexType.

Status

colour	Red
title	M

Element must be declared.

Status

title	O

Element may be omitted.

Direction

Determine when the element is used.

Status


colour	Green
title	BOTH

Provided as both input and response from the Web Service

Status

colour	Blue
title	OUTPUT

Only provided as a response from Web Service

...

ServicePricing

Type

Status

colour	Blue
title	response

Only

Useful for

Consignment Creation / Modification

Used in

GetChargeQuote

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

language	xml
theme	RDark

<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

Example

Code Block

language	xml
theme	RDark

            <ServicePricing>
               <CalculatedSUType>FP</CalculatedSUType>
               <CarrierID>102958</CarrierID>
               <CarrierName>Hi-Trans Express Pty Ltd</CarrierName>
               <CarrierService>G</CarrierService>
               <ETA/>
               <FeesCharge>25.5400</FeesCharge>
               <FreightCharge>150.1600</FreightCharge>
               <ID>0</ID>
               <NetCharge>175.7000</NetCharge>
               <RateID>10702459</RateID>
               <ServiceName>Hi Trans General Service</ServiceName>
               <ShipperService>HITRANG</ShipperService>
               <TaxCharge>17.5700</TaxCharge>
               <TotalCharge>193.2700</TotalCharge>
               <WebDescription>Hi-Trans General</WebDescription>
               <ZoneFrom>MEL</ZoneFrom>
               <ZoneTo>NS6S</ZoneTo>
            </ServicePricing>

...

Versions Compared

Old Version 4

New Version Current

Key

Introduction

Anchor
complextype_consignment
complextype_consignment
Consignment

XSD

Elements

Example

Example

Anchor
consignmentitems
consignmentitems
Consignment Item

XSD

Elements

Anchor
cp_address
cp_address
Address

XSD

Elements

Elements

ServicePricing

XSD

Elements

Example

Page Comparison

Versions Compared

Old Version 4

New Version Current

Key

Introduction

Anchorcomplextype_consignmentcomplextype_consignmentConsignment

XSD

Elements

Example

Example

Anchorconsignmentitemsconsignmentitems Consignment Item

XSD

Elements

Anchorcp_addresscp_addressAddress

XSD

Elements

Elements

ServicePricing

XSD

Elements

Example

Anchor
complextype_consignment
complextype_consignment
Consignment

Anchor
consignmentitems
consignmentitems
Consignment Item

Anchor
cp_address
cp_address
Address