๐Ÿš› DCB Logistics Enterprise Services

Enterprise API Endpoints

Complete enterprise logistics API platform supporting FreightWare authentication, FreightWare waybill creation, DCB Online/TMS draft waybill processing, DCB Online/TMS finalised waybill processing, shipment tracking, public tracking, quotation services, secure label rendering, POD extraction, POD retrieval by customer reference number, bulk POD ZIP extraction, imported waybill deletion, route resolution and postal code lookup services.

๐Ÿ” Authentication ๐Ÿšš Waybill Create ๐Ÿงพ Draft Waybills โœ… Finalised Waybills ๐Ÿ“ฆ Tracking ๐ŸŒ Public Tracking ๐Ÿ’ฐ Quick Quote ๐Ÿท๏ธ Label Extract ๐Ÿ“„ POD Extract ๐Ÿ”Ž POD By Reference ๐Ÿ—‚๏ธ Bulk POD ZIP ๐Ÿ—‘๏ธ Waybill Deletion ๐Ÿ“ Postal Lookup
13+
Enterprise Endpoints
REST
API Architecture
REST/SOAP
Backend Integrations
LIVE/UAT
Enterprise Integration
๐Ÿ”

FreightWareAuthentication

FreightWare Session Authentication Service
Endpoint
POST /api/freightwareauthentication/login
Authentication Required
NO
Returns
FreightWare Session Token

Authenticates against FreightWare and returns a secure FreightWare session token. The returned token must be supplied in the X-FreightWare request header for protected FreightWare-backed endpoints.

Request Body
{
  "Username": "string",
  "Password": "string"
}
Features
  • Authenticates directly against FreightWare
  • Returns a FreightWare session token
  • Used before calling protected FreightWare endpoints
  • Token must be supplied in the X-FreightWare header
Endpoint Flow
1. Submit FreightWare username and password

2. API authenticates with FreightWare

3. API returns FreightWare session token

4. Use returned token as: X-FreightWare : YOUR_SESSION_TOKEN
๐Ÿšš

FreightWareWaybillCreate

FreightWare Shipment & Waybill Creation
Endpoint
POST /api/freightwarewaybillcreate/create
Authentication Required
YES - X-FreightWare Required
Backend
FreightWare

Creates a waybill directly in FreightWare. The request includes consignor details, consignee details, service type, references, parcel items, dimensions, mass and routing information required by FreightWare.

Required Header
X-FreightWare : FreightWare Session Token
Features
  • Creates an operational FreightWare waybill
  • Supports shipment, consignor and consignee information
  • Supports multi-parcel waybill creation
  • Includes parcel dimensions, mass and references
  • Returns the FreightWare create result
Endpoint Flow
1. Authenticate using POST /api/freightwareauthentication/login

2. Supply X-FreightWare request header

3. Submit FreightWare waybill payload

4. FreightWare validates and creates the waybill

5. API returns the FreightWare response
๐Ÿงพ

DCBOnlineWaybillSave

DCB Online/TMS Draft Waybill Processing
Endpoint
POST /api/DCBOnlineWaybillSave
Authentication Required
NO
Platform
DCB ONLINE / TMS

Saves a draft waybill into DCB Online/TMS. This endpoint is used when a shipment must be stored in DCB Online/TMS but not yet finalised into FreightWare.

Features
  • Creates draft DCB Online/TMS waybill records
  • Creates or updates destination delivery site details
  • Saves parcel line information
  • Saves invoice reference information
  • Calculates totals, mass, volume and chargeable units
  • Uses transactional SQL rollback protection
Endpoint Flow
1. Validate shipment request payload

2. Create or update destination delivery site

3. Save waybill header as draft

4. Save parcel line information

5. Save invoice reference information

6. Commit SQL transaction if all records save successfully
โœ…

DCBOnlineWaybillFin

DCB Online/TMS Finalised Waybill Processing
Endpoint
POST /api/DCBOnlineWaybillFin
Authentication Required
YES - X-FreightWare Required
Platform
DCB ONLINE / TMS + FreightWare

Creates a finalised DCB Online/TMS waybill and pushes the shipment into FreightWare. This endpoint uses the same shipment structure as POST /api/DCBOnlineWaybillSave, but finalises the shipment instead of saving it as a draft.

Required Header
X-FreightWare : FreightWare Session Token
Features
  • Uses the same payload structure as DCBOnlineWaybillSave
  • Saves finalised DCB Online/TMS waybill records
  • Saves parcel and invoice reference information
  • Calls FreightWare waybill creation
  • Commits only after the full finalisation process succeeds
  • Uses rollback protection if any step fails
Endpoint Flow
1. Authenticate using POST /api/freightwareauthentication/login

2. Supply X-FreightWare request header

3. Submit the DCB Online/TMS waybill payload

4. Validate company, division, account, service type and parcel information

5. Save the waybill as finalised in DCB Online/TMS

6. Save parcel and invoice reference information

7. Call FreightWare waybill creation

8. Commit the transaction after all steps succeed
๐Ÿ“ฆ

AdvancedTrackTrace

Advanced FreightWare Shipment Tracking
Endpoint
POST /api/advancedtracktrace
Authentication Required
YES - Username and Password Required In Request Body
Backend
FreightWare Tracking

Retrieves advanced shipment tracking information from FreightWare. The endpoint is used when detailed waybill movement, parcel events, manifest information and POD status are required.

Request Notes
Username and password must be supplied in the JSON request body together with the waybill or tracking information required by the endpoint.
Features
  • Detailed tracking history
  • Manifest and hub movement visibility
  • Parcel-level operational visibility
  • Delivery progress and shipment status
  • POD status visibility where available
๐ŸŒ

PublicTrackAndTrace

Public Shipment Tracking Endpoint
Endpoint
GET /api/PublicTrackAndTrace/{waybillNumber}
Authentication Required
NO
Access Type
Public

Public-facing tracking endpoint allowing customers, websites, external platforms and third-party systems to retrieve shipment status using a waybill number without authentication.

Features
  • Public shipment tracking by waybill number
  • No username, password or token required
  • Returns shipment tracking milestones
  • Returns delivery progress and available POD visibility
Endpoint Flow
1. Submit waybill number in the URL

2. API retrieves public tracking details

3. API returns tracking status and milestones
๐Ÿ’ฐ

FreightWareQuickQuote

FreightWare Shipment Quotation Service
Endpoint
POST /api/FreightWareQuickQuote
Authentication Required
YES - X-FreightWare Required
Backend
FreightWare Quotes

Returns FreightWare shipment quotation estimates using account, service type, origin, destination, parcel dimensions, mass, volumetric calculations and routing information.

Required Header
X-FreightWare : FreightWare Session Token
Features
  • Returns estimated FreightWare quote values
  • Supports parcel dimensions and mass
  • Uses FreightWare account and service information
  • Can be used before waybill creation
  • Quotation values remain subject to final operational validation
๐Ÿท๏ธ

WaybillLabelExtract

Secure Browser Label Rendering
Endpoint
POST /api/waybilllabelextract/generatelink
Authentication Required
YES - X-FreightWare Required
Return Type
Temporary Label Link

Generates a secure browser-accessible link for waybill label rendering. The label includes parcel barcode information, route code details, consignee details and RDLC PDF label output.

Required Header
X-FreightWare : FreightWare Session Token
Features
  • Generates secure label access links
  • Renders labels in the browser
  • Supports parcel barcodes and route codes
  • Supports PDF/RDLC label output
  • Designed for customer portals and automated print workflows
๐Ÿ“„

eDocsPODExtract

POD PDF Retrieval By Waybill Number
Endpoint
POST /api/eDocsPODExtract
Authentication Required
YES - Username and Password Required In Request Body
Return Format
Base64 PDF

Retrieves an archived proof of delivery document directly from eDocs using the supplied waybill number. The endpoint logs into eDocs with the supplied username and password, searches for the waybill barcode and returns the POD PDF as Base64.

Request Body
{
  "Username": "string",
  "Password": "string",
  "Waybill": "string"
}
Features
  • Searches eDocs by exact waybill number
  • Uses eDocs username and password in the request body
  • Returns structured JSON response
  • Returns the POD PDF in base64Pdf
  • Useful when the DCB waybill number is already known
Endpoint Flow
1. Submit username, password and waybill number

2. API logs into eDocs

3. API searches eDocs using the waybill as barcode

4. API retrieves the POD PDF content

5. API returns the POD as Base64
๐Ÿ”Ž

eDocsPODExtractByRef

POD Retrieval By Customer Reference / Order Number
Endpoint
POST /api/eDocsPODExtractByRef
Authentication Required
YES - Username and Password Required In Request Body
Return Format
Array of Base64 PDFs

Retrieves POD documents using the customer's own reference or order number instead of a DCB waybill number. The endpoint searches DCB Online/TMS for matching waybills under the supplied account number or account numbers, then attempts to retrieve the POD for each matching waybill from eDocs.

If the same reference exists on more than one waybill, the endpoint loops through the matching waybills and returns the POD for each waybill where a POD is available. The lookup returns a maximum of 10 matching waybills per account search.

Request Body
{
  "Username": "string",
  "Password": "string",
  "AccountNumber": "string",
  "AccountNumbers": [
    "string"
  ],
  "ReferenceNumber": "string"
}
Features
  • Searches by customer reference or order number
  • Supports a single account number using AccountNumber
  • Supports multiple account numbers using AccountNumbers
  • Finds matching DCB waybill numbers from DCB Online/TMS
  • Loops through all matching waybills
  • Attempts to retrieve each available POD from eDocs
  • Returns each available POD in base64Pdf
  • Returns structured results showing POD found, no POD available or empty POD document
Endpoint Flow
1. Submit username, password, reference number and one or more account numbers

2. API searches DCB Online/TMS for matching waybills

3. API logs into eDocs

4. API loops through each matched waybill

5. API searches eDocs by waybill barcode

6. API returns all available PODs as Base64 PDF results
๐Ÿ—‚๏ธ

eDocsPODExtractByBulk

Bulk POD Retrieval By Waybill List
Endpoint
POST /api/eDocsPODExtractByBulk
Authentication Required
YES - Username and Password Required In Request Body
Return Format
Base64 ZIP
Maximum Waybills
50 Per Request

Retrieves multiple POD documents from eDocs using a supplied list of DCB waybill numbers. The endpoint logs into eDocs once, loops through each waybill number, retrieves each available POD PDF, places the PDFs into a ZIP file, and returns the ZIP as a Base64 string.

This endpoint is designed for customers who already have the DCB waybill numbers and need to download multiple PODs in one request. A maximum of 50 waybill numbers can be supplied per request to keep the response size manageable.

Request Body
{
  "Username": "string",
  "Password": "string",
  "Waybills": [
    "string"
  ]
}
Features
  • Accepts up to 50 waybill numbers per request
  • Logs into eDocs once using the supplied username and password
  • Loops through each supplied waybill number
  • Retrieves each available POD PDF from eDocs
  • Packages all available POD PDFs into one ZIP file
  • Returns the ZIP file as base64Zip
  • Includes a status text file inside the ZIP showing which PODs were found or not found
Endpoint Flow
1. Submit username, password and list of waybill numbers

2. API validates that the request contains between 1 and 50 waybills

3. API logs into eDocs

4. API loops through each waybill number

5. API searches eDocs using the waybill as barcode

6. API adds each available POD PDF into one ZIP file

7. API returns the ZIP file as Base64 using base64Zip
๐Ÿ—‘๏ธ

WaybillDeletion

Imported Waybill Deletion Service
Endpoint
POST /api/WaybillDeletion
Authentication Required
YES - Username and Password Required In Request Body
FreightWare Method
fwdelshpdp
Allowed Status
Imported Only

Deletes an imported waybill from FreightWare and then marks the matching waybill as deleted in DCB Online/TMS if the waybill exists locally. FreightWare controls the status validation and will only allow deletion when the waybill status is still Imported.

If FreightWare rejects the deletion, DCB Online/TMS will not be updated. If FreightWare deletion succeeds but the waybill does not exist in DCB Online/TMS, the local update is skipped and the API still returns a successful FreightWare deletion response.

Request Body
{
  "Username": "string",
  "Password": "string",
  "Waybill": "string",
  "DeleteReason": "string"
}
Example Request
{
  "Username": "User",
  "Password": "Pass",
  "Waybill": "DCB000123456",
  "DeleteReason": "Customer cancelled request"
}
Example Success Response
{
  "success": true,
  "message": "Waybill deleted successfully on FreightWare.",
  "waybill": "DCB000123456",
  "freightWareDeleted": true,
  "dcbOnlineUpdated": true,
  "dcbOnlineStatus": "Updated on DCB Online."
}
Features
  • Deletes imported waybills using FreightWareli>
  • Encrypts the supplied FreightWare username and password before calling FreightWare
  • Requires a freeform deletion reason using DeleteReason
  • FreightWare only allows deletion if the waybill status is Imported
  • Only updates DCB Online/TMS after FreightWare confirms deletion
  • Skips the DCB Online/TMS update if the waybill does not exist locally
Endpoint Flow
1. Submit username, password, waybill number and delete reason

2. API encrypts the username and password for FreightWare

3. API calls FreightWare

4. FreightWare validates whether the waybill can still be deleted

5. If FreightWare deletion fails, DCB Online/TMS is not updated

6. If FreightWare deletion succeeds, API marks the waybill deleted in DCB Online/TMS if found

7. API returns FreightWare deletion status and DCB Online/TMS update status
๐Ÿ“

SuburbAndPostalCodeLookup

Routing, Suburb and Postal Code Resolution Service
Endpoint
GET /api/SuburbAndPostalCodeLookup?suburb={suburb}&postalCode={postalCode}
Authentication Required
NO
Lookup Type
Suburb / Postal Code / Route

Resolves suburb, postal code, city, route code and hub information used for shipment routing, address validation and DCB Online/TMS logistics processing.

Features
  • Search by suburb and/or postal code
  • Returns routing and hub information where available
  • Useful for address validation before waybill creation
  • No authentication required
Endpoint Flow
1. Submit suburb and/or postal code in the query string

2. API searches available suburb/postal data

3. API returns matching route, hub and location information