Version | Date | Changes | Comments |
---|---|---|---|
6.1.0 | Jun 16, 2021 | Initial Version | |
6.1.1 | Feb 8, 2022 | Updated Stop Info and Load Info API | |
7.0.1 | Jun 15 2022 | Documents can be added to Pickup and Delivery | |
7.0.2 | Jun 27 2022 | New API End point for route Plan | |
7.4.0 | Jan 04 2023 | timeConstraint default value updated to Strict |
The document assumes native nuDeliverIt field-naming conventions. nuDeliverIt can be used in a wide variety of business delivery application and the field names represented here may not directly represent the use of these fields in your specific application.
It is recommended to read this document along with the understanding of integration of inbound interfaces.
Document Terminology | nuDeliverIt Use | Associated Industry Terminology |
---|---|---|
Stop | Destination for performing work activities such as delivery, pickup, service, field work etc. | Customer location, destination, site. |
Load | A sequence of stops combined and assigned to a person. The load contains all the stops in the sequence. | Work schedule, Route, truck path, delivery run, service run. |
Driver | Represents the personnel deployed for the Load | Driver, trucker, delivery man, technician |
Comments | Set of instructions sent to the driver. Comments can be associated with the stop or the load. Note: Only specific comment types are sent to the driver. | Special instructions, delivery instructions, Customer request. |
Product Identifier | Used to uniquely identify the product during delivery/pickup or use. This could represent the bar code if scanning is used in the system. | SKU barcode, Package barcode, Item barcode, service number, part, pickup tracking number, delivery tracking number. |
Host | This indicates your server from which orders or routes will be sent to nuDeliverIt server | Server |
Multi-Leg Order API provides creation on single or multiple legs of transportation from PickUp to Delivery cross-docking through multiple-hubs.
Customer Order API is used to create a request to transport goods from a customer pickup location to a drop off location. Depending on the geographic locations, cross dock facilities involved in moving the goods can be provided to generate multiple shipments tied to the customer order.
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Stop belongs to |
orderNbr | string <= 100 characters Unique alpha numeric value used to refer a Order |
orderId | string <= 50 characters Unique alpha numeric system generated id used to refer a Order Note: In above parameters either orderNbr or orderId is mandatory. |
// Import classes: import com.nuvizz.openapi.inbound.handler.ApiClient; import com.nuvizz.openapi.inbound.handler.ApiException; import com.nuvizz.openapi.inbound.handler.Configuration; import com.nuvizz.openapi.inbound.handler.auth.*; import com.nuvizz.openapi.inbound.handler.models.*; import com.nuvizz.openapi.inbound.handler.CustomerOrderApiApi; public class Example { public static void main(String[] args) { ApiClient defaultClient = Configuration.getDefaultApiClient(); defaultClient.setBasePath("https://contact-support.nuvizz.com/api-gateway/webservices/nudeliverit/v6"); // Configure HTTP basic authorization: Basic Authentication HttpBasicAuth Basic Authentication = (HttpBasicAuth) defaultClient.getAuthentication("Basic Authentication"); Basic Authentication.setUsername("YOUR USERNAME"); Basic Authentication.setPassword("YOUR PASSWORD"); CustomerOrderApiApi apiInstance = new CustomerOrderApiApi(defaultClient); String companyCode = "companyCode_example"; // String | Code of the nuDeliverIt Company to which the Stop belongs to String orderNbr = "orderNbr_example"; // String | Unique alpha numeric value used to refer a Order try { OrderSuccessResponse result = apiInstance.getOrderDetail(companyCode, orderNbr); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling CustomerOrderApiApi#getOrderDetail"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } }
{- "order": {
- "orderNbr": "Order039",
- "shipForBP": "1163",
- "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Next to McDuffys",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "XXXX",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "to": {
- "address": {
- "name": "Perimeter Mall",
- "addr1": "4400 Ashford Dunwoody Rd",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30346",
- "country": "USA",
- "landmark": "In Perimeter Mall",
- "latitude": 33.926562,
- "longitude": -84.343109
}, - "contact": {
- "contactName": "Mike",
- "email": "mike123@test.com",
- "phone": "4049371973",
- "sms": "4049371973"
}, - "schedule": {
- "timeFrom": "2020-04-21T16:00:00",
- "timeTo": "2020-04-21T18:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "shipmentNbr": "ShipmentNbr003",
- "originHub": "HUB-1",
- "xDockType": "DIRECT",
- "accountNumber": "ACC01",
- "billTo": {
- "name": "test",
- "addr1": "1001 NOrth Taylor Road",
- "addr2": null,
- "city": "Rome",
- "state": "IL",
- "zip": "60446",
- "country": "US",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "reference1": "TCS1001",
- "reference2": "TCS1002",
- "orderPriority": "Regular",
- "totalCartons": 10,
- "totalPallets": 8,
- "volume": 10,
- "volumeUOM": "CBM",
- "weight": 100,
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "assignedBillAmt": 20,
- "puAccessorials": [
- {
- "code": "LFT",
- "comments": "Lift Gate at Pickup"
}
], - "doAccessorials": [
- {
- "code": "LFT",
- "comments": "Lift Gate at Drop"
}
], - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": 1,
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "palletID": "235AZRFTG",
- "confirmationType": "P",
- "lineType": "01",
- "referenceText": "Fragile item",
- "volume": 10,
- "volumeUOM": "cubic meters",
- "weight": 100,
- "weightUOM": "kilograms",
- "length": 123.85,
- "lengthUOM": "inch",
- "width": 123.85,
- "widthUOM": "inch",
- "height": 123.85,
- "heightUOM": "inch"
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Customer Comments"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39"
}
]
}
}
Import a Single Order
serviceName required | string <= 100 characters serviceName refer to custom integration for the company, set to "default" if not using a custom integration |
companyCode required | string <= 50 characters Company Code the order belongs |
Customer Order Creation/Update request
object (Create or Update a Customer Order) | |
Array of objects (Hubs to traverse to destination) <= 10 items Required when the | |
action | string <= 10 characters action on top of a order creation
|
{- "order": {
- "orderNbr": "Order039",
- "shipForBP": "1163",
- "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Next to McDuffys",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "XXXX",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "to": {
- "address": {
- "name": "Perimeter Mall",
- "addr1": "4400 Ashford Dunwoody Rd",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30346",
- "country": "USA",
- "landmark": "In Perimeter Mall",
- "latitude": 33.926562,
- "longitude": -84.343109
}, - "contact": {
- "contactName": "Mike",
- "email": "mike123@test.com",
- "phone": "4049371973",
- "sms": "4049371973"
}, - "schedule": {
- "timeFrom": "2020-04-21T16:00:00",
- "timeTo": "2020-04-21T18:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "shipmentNbr": "ShipmentNbr003",
- "originHub": "HUB-1",
- "xDockType": "DIRECT",
- "accountNumber": "ACC01",
- "billTo": {
- "name": "test",
- "addr1": "1001 NOrth Taylor Road",
- "addr2": null,
- "city": "Rome",
- "state": "IL",
- "zip": "60446",
- "country": "US",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "reference1": "TCS1001",
- "reference2": "TCS1002",
- "orderPriority": "Regular",
- "totalCartons": 10,
- "totalPallets": 8,
- "volume": 10,
- "volumeUOM": "CBM",
- "weight": 100,
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "assignedBillAmt": 20,
- "puAccessorials": [
- {
- "code": "LFT",
- "comments": "Lift Gate at Pickup"
}
], - "doAccessorials": [
- {
- "code": "LFT",
- "comments": "Lift Gate at Drop"
}
], - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": 1,
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "palletID": "235AZRFTG",
- "confirmationType": "P",
- "lineType": "01",
- "referenceText": "Fragile item",
- "volume": 10,
- "volumeUOM": "cubic meters",
- "weight": 100,
- "weightUOM": "kilograms",
- "length": 123.85,
- "lengthUOM": "inch",
- "width": 123.85,
- "widthUOM": "inch",
- "height": 123.85,
- "heightUOM": "inch"
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Customer Comments"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39"
}
]
}
}
{- "status": "Success"
}
Import a Single Order
serviceName required | string <= 100 characters serviceName refer to custom integration for the company, set to "default" if not using a custom integration |
companyCode required | string <= 50 characters Company Code the order belongs |
Customer Order Creation/Update request
object (Create or Update a Customer Order) | |
Array of objects (Hubs to traverse to destination) <= 10 items Required when the | |
action | string <= 10 characters action on top of a order creation
|
{- "order": {
- "orderNbr": "Order039",
- "shipForBP": "1163",
- "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Next to McDuffys",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "XXXX",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "to": {
- "address": {
- "name": "Perimeter Mall",
- "addr1": "4400 Ashford Dunwoody Rd",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30346",
- "country": "USA",
- "landmark": "In Perimeter Mall",
- "latitude": 33.926562,
- "longitude": -84.343109
}, - "contact": {
- "contactName": "Mike",
- "email": "mike123@test.com",
- "phone": "4049371973",
- "sms": "4049371973"
}, - "schedule": {
- "timeFrom": "2020-04-21T16:00:00",
- "timeTo": "2020-04-21T18:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "shipmentNbr": "ShipmentNbr003",
- "originHub": "HUB-1",
- "xDockType": "DIRECT",
- "accountNumber": "ACC01",
- "billTo": {
- "name": "test",
- "addr1": "1001 NOrth Taylor Road",
- "addr2": null,
- "city": "Rome",
- "state": "IL",
- "zip": "60446",
- "country": "US",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "reference1": "TCS1001",
- "reference2": "TCS1002",
- "orderPriority": "Regular",
- "totalCartons": 10,
- "totalPallets": 8,
- "volume": 10,
- "volumeUOM": "CBM",
- "weight": 100,
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "assignedBillAmt": 20,
- "puAccessorials": [
- {
- "code": "LFT",
- "comments": "Lift Gate at Pickup"
}
], - "doAccessorials": [
- {
- "code": "LFT",
- "comments": "Lift Gate at Drop"
}
], - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": 1,
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "palletID": "235AZRFTG",
- "confirmationType": "P",
- "lineType": "01",
- "referenceText": "Fragile item",
- "volume": 10,
- "volumeUOM": "cubic meters",
- "weight": 100,
- "weightUOM": "kilograms",
- "length": 123.85,
- "lengthUOM": "inch",
- "width": 123.85,
- "widthUOM": "inch",
- "height": 123.85,
- "heightUOM": "inch"
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Customer Comments"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39"
}
]
}
}
{- "order": {
- "orderNbr": "Order039",
- "shipForBP": "1163",
- "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Next to McDuffys",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "XXXX",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "to": {
- "address": {
- "name": "Perimeter Mall",
- "addr1": "4400 Ashford Dunwoody Rd",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30346",
- "country": "USA",
- "landmark": "In Perimeter Mall",
- "latitude": 33.926562,
- "longitude": -84.343109
}, - "contact": {
- "contactName": "Mike",
- "email": "mike123@test.com",
- "phone": "4049371973",
- "sms": "4049371973"
}, - "schedule": {
- "timeFrom": "2020-04-21T16:00:00",
- "timeTo": "2020-04-21T18:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "shipmentNbr": "ShipmentNbr003",
- "originHub": "HUB-1",
- "xDockType": "DIRECT",
- "accountNumber": "ACC01",
- "billTo": {
- "name": "test",
- "addr1": "1001 NOrth Taylor Road",
- "addr2": null,
- "city": "Rome",
- "state": "IL",
- "zip": "60446",
- "country": "US",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "reference1": "TCS1001",
- "reference2": "TCS1002",
- "orderPriority": "Regular",
- "totalCartons": 10,
- "totalPallets": 8,
- "volume": 10,
- "volumeUOM": "CBM",
- "weight": 100,
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "assignedBillAmt": 20,
- "puAccessorials": [
- {
- "code": "LFT",
- "comments": "Lift Gate at Pickup"
}
], - "doAccessorials": [
- {
- "code": "LFT",
- "comments": "Lift Gate at Drop"
}
], - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": 1,
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "palletID": "235AZRFTG",
- "confirmationType": "P",
- "lineType": "01",
- "referenceText": "Fragile item",
- "volume": 10,
- "volumeUOM": "cubic meters",
- "weight": 100,
- "weightUOM": "kilograms",
- "length": 123.85,
- "lengthUOM": "inch",
- "width": 123.85,
- "widthUOM": "inch",
- "height": 123.85,
- "heightUOM": "inch"
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Customer Comments"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39"
}
]
}
}
Accept a Single Order
companyCode required | string <= 50 characters Company Code the order belongs |
Customer Order Accept request
orderNbr | string <= 100 characters Unique alpha numeric value used to refer a Order. |
orderId | string <= 50 characters Unique alpha numeric system generated id used to refer a Order Note: In above parameters either orderNbr or orderId is mandatory. |
{- "orderNbr": "Order039",
- "orderId": "1234567abcdef"
}
{- "order": {
- "orderNbr": "Order039",
- "shipForBP": "1163",
- "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Next to McDuffys",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "XXXX",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "to": {
- "address": {
- "name": "Perimeter Mall",
- "addr1": "4400 Ashford Dunwoody Rd",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30346",
- "country": "USA",
- "landmark": "In Perimeter Mall",
- "latitude": 33.926562,
- "longitude": -84.343109
}, - "contact": {
- "contactName": "Mike",
- "email": "mike123@test.com",
- "phone": "4049371973",
- "sms": "4049371973"
}, - "schedule": {
- "timeFrom": "2020-04-21T16:00:00",
- "timeTo": "2020-04-21T18:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "shipmentNbr": "ShipmentNbr003",
- "originHub": "HUB-1",
- "xDockType": "DIRECT",
- "accountNumber": "ACC01",
- "billTo": {
- "name": "test",
- "addr1": "1001 NOrth Taylor Road",
- "addr2": null,
- "city": "Rome",
- "state": "IL",
- "zip": "60446",
- "country": "US",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "reference1": "TCS1001",
- "reference2": "TCS1002",
- "orderPriority": "Regular",
- "totalCartons": 10,
- "totalPallets": 8,
- "volume": 10,
- "volumeUOM": "CBM",
- "weight": 100,
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "assignedBillAmt": 20,
- "puAccessorials": [
- {
- "code": "LFT",
- "comments": "Lift Gate at Pickup"
}
], - "doAccessorials": [
- {
- "code": "LFT",
- "comments": "Lift Gate at Drop"
}
], - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": 1,
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "palletID": "235AZRFTG",
- "confirmationType": "P",
- "lineType": "01",
- "referenceText": "Fragile item",
- "volume": 10,
- "volumeUOM": "cubic meters",
- "weight": 100,
- "weightUOM": "kilograms",
- "length": 123.85,
- "lengthUOM": "inch",
- "width": 123.85,
- "widthUOM": "inch",
- "height": 123.85,
- "heightUOM": "inch"
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Customer Comments"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39"
}
]
}
}
Delete/Reject a stop(in unplanned, created statuses)
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Stop/Order belongs to |
orderNbr | string <= 20 characters Unique alpha numeric value that refers to a Order. |
orderId | string <= 64 characters Unique alpha numeric value that refers to a Order. |
reasonCode | string <= 10 characters Code that refers to the particular nuDeliverit system code for canceling a order. |
reasonComments | string <= 500 characters Comments entered during the cancellation of a stop/order. Note: In above parameters either orderNbr or orderId is mandatory. |
{- "orderNbr": "S10001112",
- "orderId": "S10001112",
- "reasonCode": "01",
- "reasonComments": "In-valid Order details"
}
{- "reasons": [
- {
- "description": "Company Code is required.",
- "reasonCode": 1505
}
]
}
Delete an order(in created statuses)
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Order belongs to |
orderIds | Array of strings <= 50 items List of orderIds |
reason required | string <= 250 characters Mention the reason for deletion |
{- "orderIds": [
- "string"
], - "reason": "string"
}
{- "reasons": [
- {
- "description": "Company Code is required.",
- "reasonCode": 1505
}
]
}
Reject an order(in created statuses)
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Order belongs to |
orderIds | Array of strings <= 50 items List of orderIds |
reason required | string <= 250 characters Mention the reason for reject |
{- "orderIds": [
- "string"
], - "reason": "string"
}
{- "reasons": [
- {
- "description": "Company Code is required.",
- "reasonCode": 1505
}
]
}
This API provides Auth Token to execute webservice calls.
companyCode required | string <= 50 characters Code of the nuDeliverIt Company |
{- "authToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5",
- "expiresAt": 169560112,
- "reasons": [
- {
- "description": "Company Code is required.",
- "reasonCode": 1505
}
]
}
This API provides the certificate used by the auth Token to execute webservice calls.
companyCode required | string <= 50 characters Code of the nuDeliverIt Company |
{- "cert": "MIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQCKAIc+hqdKgcPb9XbR5Osbdeq1J14zxRG58CkrHZO0PMSf/smoCEyEcxhGsjrITl/sLv/q8iOVMKgYKdpOMIoPDGCF8KCXA4F9hM/WXJstprEeqPi7a1FnXzi3uwaf+jy2zUviDt09jm+guu5TaZzTuzyoClEgfwIu2LwuHaJKtjceRKHWKvUqqxBQMXlq/s5lNXWajWSpLffP",
- "reasons": [
- {
- "description": "Company Code is required.",
- "reasonCode": 1505
}
]
}
These APIs provide for Stop/Order billing information. These include
Determine the estimation of transportation cost for a stop. This operation does not create a stop
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Stop belongs to |
Stop to be estimated
required | object (Stop) |
{- "stop": {
- "stopId": "abcd123340707",
- "stopNbr": "Stop039",
- "stopSeq": "1",
- "stopType": "DO",
- "shipmentType": "REG",
- "company": {
- "code": "DCCOMP1",
- "name": "DC COMPANY"
}, - "visibility": [
- {
- "header": "string",
- "values": [
- "string"
]
}
], - "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "to": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "facility": {
- "facilityId": "63426ffabc35656",
- "label": "East Region Office"
}, - "invoiceRef": {
- "reference1": "Invoice Reference 1",
- "reference2": "Invoice Reference 2",
- "reference3": "Invoice Reference 3",
- "reference4": "Invoice Reference 4"
}, - "shipForBP": "1163",
- "shipperCode": "S201",
- "profile": "Electronics",
- "templateId": "abcd123340707",
- "consAttribute": "DNCA26R1S1021820",
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "shipmentNbr": "ShipmentNbr003",
- "receiveStatus": 3,
- "doConfirmation": "01",
- "puConfirmation": "00",
- "hubId": "LM1",
- "trailerCode": "tc2",
- "vehicleTypes": [
- "BOX",
- "TRUCK"
], - "accountNumber": "ACC01",
- "billTo": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "bol": "MBOL39203",
- "freightTerms": "new DC",
- "proNumber": "TC123",
- "reference1": "TCS1001",
- "reference2": "TCS1002",
- "sealNbr": 1,
- "stopPriority": 1,
- "totalCartons": "10",
- "totalPallets": "8",
- "volume": "10",
- "volumeUOM": "CBM",
- "weight": "100",
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "markAsReceived": true,
- "createdDttm": "2001-12-31T12:00:00",
- "receivedDttm": "2001-12-31T12:00:00",
- "laneNumber": "L1",
- "deliveryAttempt": 1,
- "altStopSeq": "A10",
- "stopGeofenceRadius": 150,
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "totalPrice": "123.85",
- "sourceType": "INTG/USER",
- "stopAccessorials": [
- {
- "code": "ACC",
- "comments": "ACC report for Stop",
- "type": "DO",
- "calcUnits": 10,
- "matchUnits": 25
}
], - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": "1",
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "palletID": "235AZRFTG",
- "orderDate": "2019-12-10",
- "toteID": 132245565,
- "trailerCode": "tcl",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "deliveryType": "DO",
- "customerPO": "100PO",
- "custRouteNbr": 151,
- "custStopNbr": 135,
- "customerOrderNbr": 124234356,
- "invoiceNbr": 102345001,
- "invoiceDate": "2019-12-09",
- "pickingNumber": "904729",
- "accountNumber": "ACC01",
- "confirmationType": "P",
- "lineType": 1,
- "referenceText": "Fragile item",
- "originalLineNumber": "10",
- "serviceCategory": "UNITS@20151021-0047-PALLET_1-003",
- "volume": "10",
- "volumeUOM": "cubic meters",
- "weight": "100",
- "weightUOM": "kilograms",
- "unitPrice": 40.1,
- "productCategory": "DRY",
- "productSubCategory": "Boxes & Trays",
- "substituteItem": true,
- "commitmentItem": true,
- "redelivery": true,
- "earliestDTTM": "2019-03-25T10:30:00",
- "latestDTTM": "2019-03-25T10:33:00",
- "length": "123.85",
- "lengthUOM": "inch",
- "width": "123.85",
- "widthUOM": "inch",
- "height": "123.85",
- "heightUOM": "inch",
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "consAttribute": "DNCA26R1S1021820",
- "collectSerialNbr": "GS1",
- "originCode": "AF2EA",
- "originName": "GS1 ATLANTA",
- "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "cartonContents": [
- {
- "itemId": "string",
- "description": "string",
- "toteId": "TCS1002",
- "qty": 0,
- "quantityUOM": "Cartons",
- "weight": "100",
- "weightUOM": "Kg",
- "reference1": "TCS1001",
- "reference2": "string",
- "shipperOrderNumber": "string",
- "custOrderNumber": "string",
- "customerComments": "In-valid details"
}
], - "confirmed": {
- "confirmedQty": "28",
- "scannedQty": "28",
- "puConfirmedQty": "28",
- "puScannedQty": "28",
- "exceptionReasonCode": "DMG",
- "exceptionComments": "Packing was damaged",
- "rcvQty": "28",
- "rcvScndQty": "28"
}
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "privateNotes": [
- {
- "userName": null,
- "description": "Stop Deliver to Cumberland Mall",
- "addedBy": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "stopAssignment": {
- "carrierCode": "XYZBP",
- "carrierName": "XYZBP"
}, - "planningType": "MANUAL",
- "routeProfile": {
- "id": "65b76331e6d05c080d1d11a4",
- "name": "Route Profile A"
}, - "assignedBillAmt": "123.25",
- "apptInfo": {
- "apptId": "345253",
- "apptStatus": "SCHEDULED",
- "apptDate": "2023-09-21",
- "startTime": "09:30",
- "endTime": "15:00",
- "comment": "Delivery timigs are strict"
}, - "trackingInfo": {
- "trackingEnabled": true,
- "trackingURL": "URL"
}, - "srvcLevel": "inch",
- "callerInfo": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "dispatcherInfo": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "estimationInfo": {
- "charges": [
- {
- "legNbr": "PU-FAC1",
- "contractId": "abcdefabcdef23248234",
- "assignedBillAmt": 234.2,
- "rateConfigEstimates": [
- {
- "code": "RT_v1",
- "guid": "abcdcdfgh",
- "rateAmt": 234.2
}
]
}
]
}
}
}
{- "estimate": {
- "contractCode": "CALD923",
- "contractId": "abcdefabcdef23248234",
- "amount": 2203.02,
- "rateDtls": [
- {
- "code": "RT_v1",
- "rateUOM": "VOLUME",
- "rateTierUOM": "VOLUME",
- "charge": 234.2,
- "tierDescription": "RateCode: 30+ ( [ 2 / 10 ] * [ 45 ]) + [0] -[0] = 39.0"
}
], - "accessorialDtls": [
- {
- "code": "LFT_GATE",
- "rateUOM": "WEIGHT",
- "rateTierUOM": "WEIGHT",
- "charge": 30,
- "tierDescription": "LIFTGATE: 50+ [0] + [0] - [0] = 50.0",
- "accType": "PU"
}
], - "fuelCharge": {
- "surchargeCode": "National",
- "fuelCode": "East Zone",
- "rateType": "PERCENTAGE",
- "charge": 40.25
}, - "surcharges": [
- {
- "code": "RT_GATE",
- "rateUOM": "WEIGHT",
- "rateTierUOM": "WEIGHT",
- "charge": 304,
- "tierDescription": "SUR1: 100+ ( [ 1 / 1 ] * [ 50 ]) + [0] -[0] = 150.0"
}
]
}
}
Determine the estimation of transportation cost for a stop. This request creates Estimates an existing stop in the sytem. If a previous estimate is present, it overwrites that estimate. multiple stops can be estimated in the request.
This request is performed when is a stop is created via various means (API/UI/Customer Portal) and stop creation calls this process in the background.
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Stop belongs to |
Stops to be estimated
Array of objects (List of StopIds) <= 100 items |
{- "stops": [
- {
- "stopId": "abcdefabcdef002342",
- "estimationInfo": {
- "charges": [
- {
- "legNbr": "PU-FAC1",
- "contractId": "abcdefabcdef23248234",
- "assignedBillAmt": 234.2,
- "rateConfigEstimates": [
- {
- "code": "RT_v1",
- "guid": "abcdcdfgh",
- "rateAmt": 234.2
}
]
}
]
}
}
]
}
null
Determine the estimation of transportation cost for a stop. This operation does not create a stop
Query params can be provided for the following groups
- stopId - First preference
- stopNbr - 2nd Preference Atleast one of the query params are required
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Stop belongs to |
stopId | string <= 50 characters StopId of the stop being inquired |
stopNbr | string <= 100 characters StopNbr of the stop being inquired |
{- "billStatus": 50,
- "estimate": {
- "contractCode": "CALD923",
- "contractId": "abcdefabcdef23248234",
- "amount": 2203.02,
- "rateDtls": [
- {
- "code": "RT_v1",
- "rateUOM": "VOLUME",
- "rateTierUOM": "VOLUME",
- "charge": 234.2,
- "tierDescription": "RateCode: 30+ ( [ 2 / 10 ] * [ 45 ]) + [0] -[0] = 39.0"
}
], - "accessorialDtls": [
- {
- "code": "LFT_GATE",
- "rateUOM": "WEIGHT",
- "rateTierUOM": "WEIGHT",
- "charge": 30,
- "tierDescription": "LIFTGATE: 50+ [0] + [0] - [0] = 50.0"
}
], - "fuelCharge": {
- "surchargeCode": "National",
- "fuelCode": "East Zone",
- "rateType": "PERCENTAGE",
- "charge": 40.25
}, - "surcharges": [
- {
- "code": "RT_GATE",
- "rateUOM": "WEIGHT",
- "rateTierUOM": "WEIGHT",
- "charge": 304,
- "tierDescription": "SUR1: 100+ ( [ 1 / 1 ] * [ 50 ]) + [0] -[0] = 150.0"
}
]
}, - "billed": {
- "contractCode": "CALD923",
- "contractId": "abcdefabcdef23248234",
- "amount": 2203.02,
- "rateDtls": [
- {
- "code": "RT_v1",
- "rateUOM": "VOLUME",
- "rateTierUOM": "VOLUME",
- "charge": 234.2,
- "tierDescription": "RateCode: 30+ ( [ 2 / 10 ] * [ 45 ]) + [0] -[0] = 39.0"
}
], - "accessorialDtls": [
- {
- "code": "LFT_GATE",
- "rateUOM": "WEIGHT",
- "rateTierUOM": "WEIGHT",
- "charge": 30,
- "tierDescription": "LIFTGATE: 50+ [0] + [0] - [0] = 50.0"
}
], - "fuelCharge": {
- "surchargeCode": "National",
- "fuelCode": "East Zone",
- "rateType": "PERCENTAGE",
- "charge": 40.25
}, - "surcharges": [
- {
- "code": "RT_GATE",
- "rateUOM": "WEIGHT",
- "rateTierUOM": "WEIGHT",
- "charge": 304,
- "tierDescription": "SUR1: 100+ ( [ 1 / 1 ] * [ 50 ]) + [0] -[0] = 150.0"
}
]
}
}
This API is used to estimate transportation cost for order. This does not create an order.
companyCode required | string <= 50 characters Company code to which order belongs to |
Customer order estimation request
required | object (Create or Update a Customer Order) |
Array of objects (Hubs to traverse to destination) <= 10 items Required when the |
{- "order": {
- "orderNbr": "Order039",
- "shipForBP": "1163",
- "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Next to McDuffys",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "XXXX",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "to": {
- "address": {
- "name": "Perimeter Mall",
- "addr1": "4400 Ashford Dunwoody Rd",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30346",
- "country": "USA",
- "landmark": "In Perimeter Mall",
- "latitude": 33.926562,
- "longitude": -84.343109
}, - "contact": {
- "contactName": "Mike",
- "email": "mike123@test.com",
- "phone": "4049371973",
- "sms": "4049371973"
}, - "schedule": {
- "timeFrom": "2020-04-21T16:00:00",
- "timeTo": "2020-04-21T18:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "shipmentNbr": "ShipmentNbr003",
- "originHub": "HUB-1",
- "xDockType": "DIRECT",
- "accountNumber": "ACC01",
- "billTo": {
- "name": "test",
- "addr1": "1001 NOrth Taylor Road",
- "addr2": null,
- "city": "Rome",
- "state": "IL",
- "zip": "60446",
- "country": "US",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "reference1": "TCS1001",
- "reference2": "TCS1002",
- "orderPriority": "Regular",
- "totalCartons": 10,
- "totalPallets": 8,
- "volume": 10,
- "volumeUOM": "CBM",
- "weight": 100,
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "puAccessorials": [
- {
- "code": "LFT",
- "comments": "Lift Gate at Pickup"
}
], - "doAccessorials": [
- {
- "code": "LFT",
- "comments": "Lift Gate at Drop"
}
], - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": 1,
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "palletID": "235AZRFTG",
- "confirmationType": "P",
- "lineType": "01",
- "referenceText": "Fragile item",
- "volume": 10,
- "volumeUOM": "cubic meters",
- "weight": 100,
- "weightUOM": "kilograms",
- "length": 123.85,
- "lengthUOM": "inch",
- "width": 123.85,
- "widthUOM": "inch",
- "height": 123.85,
- "heightUOM": "inch"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
]
}, - "legs": [
- {
- "leg": null,
- "hubId": "HUB-1",
- "legType": "PU",
- "puDttm": "2023-08-10T14:00:00"
}, - {
- "leg": null,
- "hubId": "HUB-1",
- "legType": "DO",
- "puDttm": "2023-08-11T15:00:00",
- "refHub": "HUB-2"
}, - {
- "leg": null,
- "hubId": "HUB-2",
- "legType": "DO",
- "puDttm": "2023-08-13T14:00:00"
}
]
}
{- "charges": [
- {
- "contractCode": "CALD923",
- "contractId": "abcdefabcdef23248234",
- "amount": 608.45,
- "rateDtls": [
- {
- "code": "RT_v1",
- "rateUOM": "VOLUME",
- "rateTierUOM": "VOLUME",
- "charge": 234.2,
- "tierDescription": "RateCode: 30+ ( [ 2 / 10 ] * [ 45 ]) + [0] -[0] = 39.0"
}
], - "accessorialDtls": [
- {
- "code": "LFT_GATE",
- "rateUOM": "WEIGHT",
- "rateTierUOM": "WEIGHT",
- "charge": 30,
- "tierDescription": "LIFTGATE: 50+ [0] + [0] - [0] = 50.0",
- "accType": "PU"
}
], - "fuelCharge": {
- "surchargeCode": "National",
- "fuelCode": "East Zone",
- "rateType": "PERCENTAGE",
- "charge": 40.25
}, - "surcharges": [
- {
- "code": "RT_GATE",
- "rateUOM": "WEIGHT",
- "rateTierUOM": "WEIGHT",
- "charge": 304,
- "tierDescription": "SUR1: 100+ ( [ 1 / 1 ] * [ 50 ]) + [0] -[0] = 150.0"
}
]
}
], - "summary": {
- "totalAmount": 608.45,
- "freightAmount": 234.2,
- "accessorialAmount": 30,
- "fuelAmount": 40.25,
- "surchargeAmount": 304
}
}
Create order estimate charge entry If the order is not completed
Create final charge entry if the order is completed.
companyCode required | string <= 50 characters Company code to which order belong to |
Orders to be estimated
Array of objects (List of orders) <= 100 items |
{- "orders": [
- {
- "orderId": "string",
- "estimationInfo": {
- "charges": [
- {
- "legNbr": "PU-FAC1",
- "contractId": "abcdefabcdef23248234",
- "assignedBillAmt": 234.2,
- "rateConfigEstimates": [
- {
- "code": "RT_v1",
- "guid": "abcdcdfgh",
- "rateAmt": 234.2
}
]
}
]
}
}
]
}
null
This API is used to get contract information
companyCode required | string Company Code of contract |
level required | string <= 10 characters Allowed values are |
object (MiscInfo) Information which is used to generate non-transportation charges | |
object (Stop) |
{- "level": "STOP",
- "stop": {
- "stopNbr": "Stop039",
- "trailerCode": "tc1",
- "stopSeq": 1,
- "stopType": "DO",
- "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "XXXX",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey",
- "to": {
- "address": {
- "name": "Test-Stop",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "mike123@test.com",
- "phone": "4049371973",
- "sms": "4049371973"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "XXXX",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}
}, - "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974,",
- "sms": "3489865974,"
}
}, - "billTo": {
- "name": "test",
- "addr1": "1001 NOrth Taylor Road",
- "addr2": null,
- "city": "Rome",
- "state": "IL",
- "zip": "60446",
- "country": "US",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "bol": "eManifestNumber",
- "puConfirmation": "SKIP",
- "doConfirmation": "SCAN-VER",
- "profile": "Electronics",
- "stopDetails": [
- {
- "product": "ca629-2-3",
- "productIdentifier": "zx_24",
- "productCategory": "DRY",
- "deliveryType": "DO",
- "quantity": 1,
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "markfor": {
- "address": {
- "name": "HARRINGTON SURG.SUP.",
- "addr1": "1503 SOUTH RUSSELL STREET",
- "addr2": "",
- "city": "MISSOULA",
- "state": "MT",
- "zip": "59801",
- "country": "US",
- "landmark": "Hub001",
- "latitude": null,
- "longitude": null
}, - "contact": {
- "contactName": "Test-Stop",
- "email": null,
- "phone": null,
- "sms": null
}
}, - "custRouteNbr": 151,
- "custStopNbr": 135,
- "customerPO": "100PO",
- "customerOrderNbr": 124234356,
- "orderDate": "2019-12-10T00:00:00.000Z",
- "invoiceNbr": 102345001,
- "invoiceDate": "2019-12-09T00:00:00.000Z",
- "accountNumber": "ACC01",
- "toteID": 132245565,
- "trailerCode": "tc1",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "palletID": "235AZRFTG",
- "earliestDTTM": "2020-01-22T10:25:00",
- "latestDTTM": "2020-01-22T10:30:00",
- "consAttribute": "DNCA26R1S1021820",
- "collectSerialNbr": "GS1",
- "comments": {
- "commentType": 5,
- "commentDescription": "Carton should be in cooler all time"
}
}, - {
- "productIdentifier": "cx_300",
- "productCategory": "DRY",
- "deliveryType": "DO",
- "quantity": 1,
- "quantityUOM": "Cartons",
- "stopDetailSeq": 2,
- "markfor": {
- "address": {
- "name": "HARRINGTON SURG.SUP.",
- "addr1": "1503 SOUTH RUSSELL STREET",
- "addr2": "",
- "city": "MISSOULA",
- "state": "MT",
- "zip": "59801",
- "country": "US",
- "landmark": null,
- "latitude": null,
- "longitude": null
}, - "contact": {
- "contactName": null,
- "email": null,
- "phone": null,
- "sms": null
}
}, - "custRouteNbr": 151,
- "custStopNbr": 135,
- "customerPO": "100PO",
- "customerOrderNbr": 124234356,
- "orderDate": "2019-12-10T00:00:00.000Z",
- "invoiceNbr": 102345001,
- "invoiceDate": "2019-12-09T00:00:00.000Z",
- "accountNumber": "ACC02",
- "toteID": 132245565,
- "trailerCode": "tc1",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "palletID": "235AZRFTG",
- "earliestDTTM": "2020-01-22T10:25:00",
- "latestDTTM": "2020-01-22T10:26:00",
- "consAttribute": "DNCA26R1S1021820",
- "collectSerialNbr": "GS1"
}
]
}
}
{- "contract": {
- "id": "64a66315f820ad378784f425",
- "code": "CC1",
- "type": "CUSTOMER",
- "level": "STOP",
- "effectiveDate": "2024-04-19",
- "partnerCode": "ABCBP1",
- "serviceLevels": [
- "EXPRESS",
- "ONEDAY"
], - "uomType": "IMPERIAL",
- "weightUOM": "POUNDS",
- "volumeUOM": "CU_FEET",
- "distanceUOM": "MILES",
- "durationUOM": "MIN",
- "rateCard": {
- "rateConfigId": "64a66315f820ad378784f489",
- "name": "RateCard1",
- "effectiveDate": "2023-07-11",
- "minCharge": 100,
- "billMode": "RATE_TIER",
- "updatedBy": "Adam Smith",
- "updatedOn": "2024-03-21T12:30:45",
- "rates": [
- {
- "guid": "abcdahf",
- "code": "R1",
- "chargeBy": "TIER",
- "criterias": [
- {
- "fieldName": "originName",
- "operator": "eq",
- "value": "BLR",
- "type": "string"
}, - {
- "fieldName": "vehicleType",
- "operator": "in",
- "value": "TRUCK,SEDAN",
- "type": "string"
}, - {
- "fieldName": "timecondition",
- "operator": "in",
- "type": "custom",
- "dow": "MT",
- "startTime": "09:00",
- "endTime": "13:30",
- "startDate": "2024-04-19",
- "endDate": "2024-04-30"
}
], - "driverPayBy": "NOTREQD",
- "custCharge": {
- "desc": "charge by weight",
- "glCode": "GL100001",
- "adjType": "DISC",
- "adjPerc": 10,
- "matchTierBy": "WEIGHT",
- "calculateChargeBy": "WEIGHT",
- "roundUpTo": 10,
- "chargePerUnits": 5,
- "chargeAt": "STOP",
- "weightFactor": "DEFICIT",
- "weightType": "DIMWT",
- "dimFactor": 11,
- "tiers": [
- {
- "upTo": 250,
- "baseRate": 500,
- "freeUnits": 100,
- "varRate": 10.5,
- "minCharge": 100,
- "maxCharge": 5000,
- "payPerc": 10.1
}, - {
- "upTo": 550,
- "baseRate": 750,
- "freeUnits": 150,
- "varRate": 12.5,
- "minCharge": 250,
- "maxCharge": 5000,
- "payPerc": 10.1
}
]
}, - "updatedBy": "Adam Smith",
- "updatedOn": "2024-03-21T12:30:45"
}, - {
- "guid": "abcdahf",
- "code": "R2",
- "chargeBy": "ZIPZONE",
- "criterias": [
- {
- "fieldName": "originName",
- "operator": "eq",
- "value": "BLR",
- "type": "string"
}
], - "driverPayBy": "FIXED",
- "custCharge": {
- "desc": "charge by weight",
- "glCode": "GL100001",
- "adjType": "MARKUP",
- "adjPerc": 10,
- "zipZoneRate": "ZIPZONE123",
- "zipZone": "ZONE123"
}, - "driverCharge": {
- "desc": "charge by weight",
- "glCode": "GL100001",
- "adjType": "MARKUP",
- "adjPerc": 10,
- "fixedAmount": 500
}, - "updatedBy": "Adam Smith",
- "updatedOn": "2024-03-21T12:30:45"
}
], - "accessorials": [
- {
- "guid": "abcdahf",
- "code": "ACC1",
- "chargeBy": "FIXED",
- "criterias": [
- {
- "fieldName": "originName",
- "operator": "eq",
- "value": "BLR",
- "type": "string"
}
], - "driverPayBy": "PERC",
- "custCharge": {
- "desc": "charge by weight",
- "glCode": "GL100001",
- "adjType": "MARKUP",
- "adjPerc": 10,
- "fixedAmount": 500
}, - "driverCharge": {
- "desc": "charge by weight",
- "glCode": "GL100001",
- "adjType": "MARKUP",
- "adjPerc": 10,
- "chargePerc": 12.5
}, - "updatedBy": "Adam Smith",
- "updatedOn": "2024-03-21T12:30:45"
}
], - "fuelCharge": {
- "chargeType": "COST",
- "invoiceDesc": "Fuel cost",
- "custGLCode": "GL001177",
- "driverGLCode": "GL0001199",
- "chargeDetails": [
- {
- "vehicleTypes": [
- "TRUCK",
- "SEDAN"
], - "serviceLevels": [
- "EXPRESS",
- "ONEDAY"
], - "fuelPriceCode": "EASTZONE",
- "driverPayPerc": 10.1,
- "surchargeCode": "SURCHARGE1"
}
], - "updatedBy": "Adam Smith",
- "updatedOn": "2024-03-21T12:30:45"
}, - "surcharges": [
- {
- "guid": "abcdahf",
- "code": "SUR1",
- "chargeBy": "DWELL_TIME",
- "criterias": [
- {
- "fieldName": "originName",
- "operator": "eq",
- "value": "BLR",
- "type": "string"
}
], - "driverPayBy": "AMT",
- "custCharge": {
- "desc": "charge by weight",
- "glCode": "GL100001",
- "adjType": "MARKUP",
- "adjPerc": 10,
- "freeTime": 20,
- "chargePerUnits": 10,
- "varRate": 2
}, - "driverCharge": {
- "desc": "charge by weight",
- "glCode": "GL100001",
- "adjType": "MARKUP",
- "adjPerc": 10,
- "freeTime": 20,
- "chargePerUnits": 5,
- "varRate": 2
}, - "updatedBy": "Adam Smith",
- "updatedOn": "2024-03-21T12:30:45"
}
]
}
}
}
Create stop from Doc
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Stop belongs to |
templateName | string <= 100 characters Name of the Doc Mapping template to be used |
filename | string <binary> |
{- "stop": {
- "stopId": "abcd123340707",
- "stopNbr": "Stop039",
- "stopSeq": "1",
- "stopType": "DO",
- "shipmentType": "REG",
- "company": {
- "code": "DCCOMP1",
- "name": "DC COMPANY"
}, - "visibility": [
- {
- "header": "string",
- "values": [
- "string"
]
}
], - "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "to": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "facility": {
- "facilityId": "63426ffabc35656",
- "label": "East Region Office"
}, - "invoiceRef": {
- "reference1": "Invoice Reference 1",
- "reference2": "Invoice Reference 2",
- "reference3": "Invoice Reference 3",
- "reference4": "Invoice Reference 4"
}, - "shipForBP": "1163",
- "shipperCode": "S201",
- "profile": "Electronics",
- "templateId": "abcd123340707",
- "consAttribute": "DNCA26R1S1021820",
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "shipmentNbr": "ShipmentNbr003",
- "receiveStatus": 3,
- "doConfirmation": "01",
- "puConfirmation": "00",
- "hubId": "LM1",
- "trailerCode": "tc2",
- "vehicleTypes": [
- "BOX",
- "TRUCK"
], - "accountNumber": "ACC01",
- "billTo": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "bol": "MBOL39203",
- "freightTerms": "new DC",
- "proNumber": "TC123",
- "reference1": "TCS1001",
- "reference2": "TCS1002",
- "sealNbr": 1,
- "stopPriority": 1,
- "totalCartons": "10",
- "totalPallets": "8",
- "volume": "10",
- "volumeUOM": "CBM",
- "weight": "100",
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "markAsReceived": true,
- "createdDttm": "2001-12-31T12:00:00",
- "receivedDttm": "2001-12-31T12:00:00",
- "laneNumber": "L1",
- "deliveryAttempt": 1,
- "altStopSeq": "A10",
- "stopGeofenceRadius": 150,
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "totalPrice": "123.85",
- "sourceType": "INTG/USER",
- "stopAccessorials": [
- {
- "code": "ACC",
- "comments": "ACC report for Stop",
- "type": "DO",
- "calcUnits": 10,
- "matchUnits": 25
}
], - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": "1",
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "palletID": "235AZRFTG",
- "orderDate": "2019-12-10",
- "toteID": 132245565,
- "trailerCode": "tcl",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "deliveryType": "DO",
- "customerPO": "100PO",
- "custRouteNbr": 151,
- "custStopNbr": 135,
- "customerOrderNbr": 124234356,
- "invoiceNbr": 102345001,
- "invoiceDate": "2019-12-09",
- "pickingNumber": "904729",
- "accountNumber": "ACC01",
- "confirmationType": "P",
- "lineType": 1,
- "referenceText": "Fragile item",
- "originalLineNumber": "10",
- "serviceCategory": "UNITS@20151021-0047-PALLET_1-003",
- "volume": "10",
- "volumeUOM": "cubic meters",
- "weight": "100",
- "weightUOM": "kilograms",
- "unitPrice": 40.1,
- "productCategory": "DRY",
- "productSubCategory": "Boxes & Trays",
- "substituteItem": true,
- "commitmentItem": true,
- "redelivery": true,
- "earliestDTTM": "2019-03-25T10:30:00",
- "latestDTTM": "2019-03-25T10:33:00",
- "length": "123.85",
- "lengthUOM": "inch",
- "width": "123.85",
- "widthUOM": "inch",
- "height": "123.85",
- "heightUOM": "inch",
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "consAttribute": "DNCA26R1S1021820",
- "collectSerialNbr": "GS1",
- "originCode": "AF2EA",
- "originName": "GS1 ATLANTA",
- "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "cartonContents": [
- {
- "itemId": "string",
- "description": "string",
- "toteId": "TCS1002",
- "qty": 0,
- "quantityUOM": "Cartons",
- "weight": "100",
- "weightUOM": "Kg",
- "reference1": "TCS1001",
- "reference2": "string",
- "shipperOrderNumber": "string",
- "custOrderNumber": "string",
- "customerComments": "In-valid details"
}
], - "confirmed": {
- "confirmedQty": "28",
- "scannedQty": "28",
- "puConfirmedQty": "28",
- "puScannedQty": "28",
- "exceptionReasonCode": "DMG",
- "exceptionComments": "Packing was damaged",
- "rcvQty": "28",
- "rcvScndQty": "28"
}
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "privateNotes": [
- {
- "userName": null,
- "description": "Stop Deliver to Cumberland Mall",
- "addedBy": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "stopAssignment": {
- "carrierCode": "XYZBP",
- "carrierName": "XYZBP"
}, - "planningType": "MANUAL",
- "routeProfile": {
- "id": "65b76331e6d05c080d1d11a4",
- "name": "Route Profile A"
}, - "assignedBillAmt": "123.25",
- "apptInfo": {
- "apptId": "345253",
- "apptStatus": "SCHEDULED",
- "apptDate": "2023-09-21",
- "startTime": "09:30",
- "endTime": "15:00",
- "comment": "Delivery timigs are strict"
}, - "trackingInfo": {
- "trackingEnabled": true,
- "trackingURL": "URL"
}, - "srvcLevel": "inch",
- "callerInfo": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "dispatcherInfo": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "estimationInfo": {
- "charges": [
- {
- "legNbr": "PU-FAC1",
- "contractId": "abcdefabcdef23248234",
- "assignedBillAmt": 234.2,
- "rateConfigEstimates": [
- {
- "code": "RT_v1",
- "guid": "abcdcdfgh",
- "rateAmt": 234.2
}
]
}
]
}
}, - "reasons": [
- {
- "description": "Company Code is required.",
- "reasonCode": 1505
}
]
}
Create/Update Vendor Master
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Vendor belongs to |
Create Or Update Vendor Master
companyCode required | string <= 50 characters CompanyCode to which the Vendor belongs |
required | Array of objects (Vendors) <= 100 items |
{- "companyCode": "001Test",
- "vendors": [
- {
- "vendorId": "abcdef123456",
- "accountNumber": "ACC01",
- "name": "customer1",
- "billTo": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "contracts": [
- "PRO1",
- "PRO2"
], - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "status": "ACTIVE",
- "partnerCode": "ABC",
- "updatedBy": "Smith",
- "lastUpdateDTTM": "2024-05-30T12:00:00",
- "sourceType": "INTG/USER"
}
]
}
{- "reasons": [
- {
- "description": "Company Code is required.",
- "reasonCode": 1505
}
]
}
List of Vendors with Pagination
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Vendor belongs to |
Vendor List Request
object (PaginationAPIRequest) | |
accountNumber | string <= 20 characters Search Criteria for Account Number of the Vendor |
name | string <= 50 characters Search Criteria for Vendor Name |
{- "listReq": {
- "pageSize": 20,
- "page": 1,
- "maxResult": 30
}, - "accountNumber": "ACC01",
- "name": "john"
}
{- "totalRecords": 81,
- "defaultSize": 20,
- "currentPageSize": 1,
- "pageNo": 5,
- "vendors": [
- {
- "vendorId": "abcdef123456",
- "accountNumber": "ACC01",
- "name": "customer1",
- "status": "ACTIVE"
}
]
}
If Account Number exists for the Vendor, it will return Vendor Info
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Vendor belongs to |
accountNumber | string <= 50 characters Unique alpha numeric value used to refer a Vendor |
vendorId | string <= 50 characters Unique internal Id of Vendor. vendorId takes precedence over accountNumber. Note: In query parameters either accountNumber or vendorId is mandatory. |
{- "vendor": {
- "vendorId": "abcdef123456",
- "accountNumber": "ACC01",
- "name": "customer1",
- "billTo": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "contracts": [
- "PRO1",
- "PRO2"
], - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "status": "ACTIVE",
- "partnerCode": "ABC",
- "updatedBy": "Smith",
- "lastUpdateDTTM": "2024-05-30T12:00:00",
- "sourceType": "INTG/USER"
}
}
Return the event information for entity provided.
companyCode required | string <= 50 characters Company Code which the entity belongs to. |
entityType required | string <= 50 characters Entity for which the event details are required.
|
entityId required | string <= 50 characters Unique alpha numeric system generated id used to refer a entity. |
{- "events": [
- {
- "entityType": "STOP",
- "entityId": "string",
- "eventCode": 7008,
- "eventName": "Stop Departure",
- "eventDTTM": "2024-05-21T12:00:00",
- "userName": "John Smith",
- "companyCode": "XYZ",
- "companyName": "DC Company",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "routeid": "234544sadec0000000a23451",
- "routeNbr": "L1230001",
- "documentKey": "string",
- "docInfo": {
- "docName": "Cumberland Mall Delivery",
- "docExtension": "pdf",
- "docPath": "/documents/cumberland-mall-delivery.pdf"
}
}
], - "reasons": [
- {
- "description": "Company Code is required.",
- "reasonCode": 1505
}
]
}
If the Load ID exists then it will return the load info along with events.
companyCode required | string <= 50 characters Company code to which the Load belongs |
loadNbr required | string <= 100 characters Unique alphanumeric value used to refer a Load |
// Import classes: import com.nuvizz.openapi.inbound.handler.ApiClient; import com.nuvizz.openapi.inbound.handler.ApiException; import com.nuvizz.openapi.inbound.handler.Configuration; import com.nuvizz.openapi.inbound.handler.auth.*; import com.nuvizz.openapi.inbound.handler.models.*; import com.nuvizz.openapi.inbound.handler.LoadApiApi; public class Example { public static void main(String[] args) { ApiClient defaultClient = Configuration.getDefaultApiClient(); defaultClient.setBasePath("https://contact-support.nuvizz.com/api-gateway/webservices/nudeliverit/v5"); // Configure HTTP basic authorization: Basic Authentication HttpBasicAuth Basic Authentication = (HttpBasicAuth) defaultClient.getAuthentication("Basic Authentication"); Basic Authentication.setUsername("YOUR USERNAME"); Basic Authentication.setPassword("YOUR PASSWORD"); LoadApiApi apiInstance = new LoadApiApi(defaultClient); String companyCode = "companyCode_example"; // String | Company code to which the Load belongs to String loadNbr = "loadNbr_example"; // String | Unique alphanumeric value used to refer a Load try { LoadInfoSuccessResponse result = apiInstance.getLoadDetail(companyCode, loadNbr); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling LoadApiApi#getLoadDetail"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } }
{- "Load": {
- "loadHeader": {
- "loadId": "abcd123340707",
- "loadNbr": "Load_ND_1",
- "routeName": "Route-101",
- "earliestStartDttm": "2020-04-21T12:00:00",
- "latestStartDttm": "2020-04-21T16:00:00",
- "signatureRequired": true,
- "originAddr1": "1000 Circle 75 Pkwy",
- "originAddr2": "Villa Chase Drive",
- "originCity": "Atlanta",
- "originState": "GA",
- "originZip": 30339,
- "originCountry": "US",
- "origin": "nuVizz",
- "originName": "nuVizz Inc",
- "originPhoneNumber": 4073241456,
- "loadTimeZone": "US/Eastern",
- "originLatitude": 37.998789,
- "originLongitude": -87.788786,
- "rtOrigin": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "depot": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "facility": {
- "facilityId": "63426ffabc35656",
- "label": "East Region Office"
}, - "masterBol": "567BGH",
- "pronbr": "PRO2392382",
- "reference": "123a1",
- "reference2": "123a2",
- "reference3": "123a3",
- "sealNbr": "SN123",
- "stopSeqOrder": "1",
- "totalCartons": "10",
- "totalPallets": "8",
- "tractorNbr": "123TriNBR",
- "trailerNbr": "234TRCNBR",
- "trailerSize": "full or partial",
- "trailerType": "TrailerType",
- "vehicleType": "Box truck",
- "volume": 3000,
- "volumeUOM": "CU.FT.",
- "weight": 244,
- "weightUOM": "LBS",
- "contractCode": 1,
- "cusAccNbr": "UTE123",
- "cusBillAmt": 35.25,
- "profile": "Electronics",
- "prePlannedLoadDistance": 34.4,
- "prePlannedLoadDuration": 3.5,
- "returnToDepot": "ALWAYS",
- "delayReasonCode": 11,
- "delayReasonCodeComment": "Delay due to traffic congestion",
- "workType": "CustomerSurveyForm",
- "congestionFactor": 1.9,
- "sourceType": "INTG/USER",
- "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "assignedBillAmt": "123.25",
- "stagingLocation": "stage-1",
- "plannedETAWindow": "30",
- "maxRouteTime": "30",
- "shiftType": "FIXED",
- "maxDistMiles": "123.25",
- "cutOffTime": "2020-04-21T12:00:00"
}, - "loadExecutionInfo": {
- "loadStatus": 90,
- "actualStartDTTM": "2020-04-21T11:00:00",
- "actualStartTimeZone": "America/New_York",
- "actualEndDTTM": "2020-04-21T16:00:00",
- "actualEndTimeZone": "America/New_York",
- "plannedDistanceMiles": "13.72",
- "actualDistanceMiles": "12.72",
- "stopsOnRoute": "10",
- "stopsVisibleOnRoute": "3",
- "plannedDuration": 20.12,
- "actualDuration": 20.12
}, - "loadAssignment": {
- "carrierCode": "XYZBP",
- "assignmentCriteria": 1,
- "driverCdl": 98724890,
- "driverEmail": "driver1@test.com",
- "driverName": "John Smith",
- "driverUserName": "JohnSmith",
- "driverPhoneNumber": "string"
}, - "stops": [
- {
- "stop": {
- "stopId": "abcd123340707",
- "stopNbr": "Stop039",
- "stopSeq": "1",
- "stopType": "DO",
- "shipmentType": "REG",
- "company": {
- "code": "DCCOMP1",
- "name": "DC COMPANY"
}, - "visibility": [
- {
- "header": "string",
- "values": [
- "string"
]
}
], - "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": null,
- "signatoryName": null,
- "optional": null
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "to": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": null,
- "signatoryName": null,
- "optional": null
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "facility": {
- "facilityId": "63426ffabc35656",
- "label": "East Region Office"
}, - "invoiceRef": {
- "reference1": "Invoice Reference 1",
- "reference2": "Invoice Reference 2",
- "reference3": "Invoice Reference 3",
- "reference4": "Invoice Reference 4"
}, - "shipForBP": "1163",
- "shipperCode": "S201",
- "profile": "Electronics",
- "templateId": "abcd123340707",
- "consAttribute": "DNCA26R1S1021820",
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "shipmentNbr": "ShipmentNbr003",
- "receiveStatus": 3,
- "doConfirmation": "01",
- "puConfirmation": "00",
- "hubId": "LM1",
- "trailerCode": "tc2",
- "vehicleTypes": [
- "BOX",
- "TRUCK"
], - "accountNumber": "ACC01",
- "billTo": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "bol": "MBOL39203",
- "freightTerms": "new DC",
- "proNumber": "TC123",
- "reference1": "TCS1001",
- "reference2": "TCS1002",
- "sealNbr": 1,
- "stopPriority": 1,
- "totalCartons": "10",
- "totalPallets": "8",
- "volume": "10",
- "volumeUOM": "CBM",
- "weight": "100",
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "markAsReceived": true,
- "createdDttm": "2001-12-31T12:00:00",
- "receivedDttm": "2001-12-31T12:00:00",
- "laneNumber": "L1",
- "deliveryAttempt": 1,
- "altStopSeq": "A10",
- "stopGeofenceRadius": 150,
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "totalPrice": "123.85",
- "sourceType": "INTG/USER",
- "stopAccessorials": [
- {
- "code": "ACC",
- "comments": "ACC report for Stop",
- "type": "DO",
- "calcUnits": 10,
- "matchUnits": 25
}
], - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": "1",
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "palletID": "235AZRFTG",
- "orderDate": "2019-12-10",
- "toteID": 132245565,
- "trailerCode": "tcl",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "deliveryType": "DO",
- "customerPO": "100PO",
- "custRouteNbr": 151,
- "custStopNbr": 135,
- "customerOrderNbr": 124234356,
- "invoiceNbr": 102345001,
- "invoiceDate": "2019-12-09",
- "pickingNumber": "904729",
- "accountNumber": "ACC01",
- "confirmationType": "P",
- "lineType": 1,
- "referenceText": "Fragile item",
- "originalLineNumber": "10",
- "serviceCategory": "UNITS@20151021-0047-PALLET_1-003",
- "volume": "10",
- "volumeUOM": "cubic meters",
- "weight": "100",
- "weightUOM": "kilograms",
- "unitPrice": 40.1,
- "productCategory": "DRY",
- "productSubCategory": "Boxes & Trays",
- "substituteItem": true,
- "commitmentItem": true,
- "redelivery": true,
- "earliestDTTM": "2019-03-25T10:30:00",
- "latestDTTM": "2019-03-25T10:33:00",
- "length": "123.85",
- "lengthUOM": "inch",
- "width": "123.85",
- "widthUOM": "inch",
- "height": "123.85",
- "heightUOM": "inch",
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "consAttribute": "DNCA26R1S1021820",
- "collectSerialNbr": "GS1",
- "originCode": "AF2EA",
- "originName": "GS1 ATLANTA",
- "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "cartonContents": [
- {
- "itemId": "string",
- "description": "string",
- "toteId": "TCS1002",
- "qty": 0,
- "quantityUOM": "Cartons",
- "weight": "100",
- "weightUOM": "Kg",
- "reference1": "TCS1001",
- "reference2": "string",
- "shipperOrderNumber": "string",
- "custOrderNumber": "string",
- "customerComments": "In-valid details"
}
], - "confirmed": {
- "confirmedQty": "28",
- "scannedQty": "28",
- "puConfirmedQty": "28",
- "puScannedQty": "28",
- "exceptionReasonCode": "DMG",
- "exceptionComments": "Packing was damaged",
- "rcvQty": "28",
- "rcvScndQty": "28"
}
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "privateNotes": [
- {
- "userName": null,
- "description": "Stop Deliver to Cumberland Mall",
- "addedBy": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "stopAssignment": {
- "carrierCode": "XYZBP",
- "carrierName": "XYZBP"
}, - "planningType": "MANUAL",
- "routeProfile": {
- "id": "65b76331e6d05c080d1d11a4",
- "name": "Route Profile A"
}, - "assignedBillAmt": "123.25",
- "apptInfo": {
- "apptId": "345253",
- "apptStatus": "SCHEDULED",
- "apptDate": "2023-09-21",
- "startTime": "09:30",
- "endTime": "15:00",
- "comment": "Delivery timigs are strict"
}, - "trackingInfo": {
- "trackingEnabled": true,
- "trackingURL": "URL"
}, - "srvcLevel": "inch",
- "callerInfo": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "dispatcherInfo": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "estimationInfo": {
- "charges": [
- {
- "legNbr": "PU-FAC1",
- "contractId": "abcdefabcdef23248234",
- "assignedBillAmt": 234.2,
- "rateConfigEstimates": [
- {
- "code": null,
- "guid": null,
- "rateAmt": null
}
]
}
]
}
}, - "stopExecutionInfo": {
- "stopStatus": "10",
- "receiveStatus": "st",
- "receiveDTTM": "2022-03-25T10:30:00",
- "from": {
- "plannedEtaDTTM": "2022-03-25T10:30:00",
- "etaDttm": "2022-03-25T10:30:00",
- "arrivalDTTM": "2022-03-25T10:30:00",
- "confirmedDTTM": "2022-03-25T10:30:00",
- "departureDTTM": "2022-03-25T10:30:00",
- "duration": 22,
- "etaCode": "string",
- "podDoc": [
- {
- "createdTime": "2022-03-25T10:30:00",
- "documentName": "Cumberland Mall Delivery",
- "documentPath": "/path/to/document.pdf",
- "documentGuid": "123e4567-e89b-12d3-a456-426614174000",
- "extension": "pdf"
}
]
}, - "to": {
- "plannedEtaDTTM": "2022-03-25T10:30:00",
- "etaDttm": "2022-03-25T10:30:00",
- "arrivalDTTM": "2022-03-25T10:30:00",
- "confirmedDTTM": "2022-03-25T10:30:00",
- "departureDTTM": "2022-03-25T10:30:00",
- "duration": 22,
- "etaCode": "string",
- "podDoc": [
- {
- "createdTime": "2022-03-25T10:30:00",
- "documentName": "Cumberland Mall Delivery",
- "documentPath": "/path/to/document.pdf",
- "documentGuid": "123e4567-e89b-12d3-a456-426614174000",
- "extension": "pdf"
}
]
}, - "exceptionPresent": true,
- "exceptions": [
- {
- "exceptionCode": "AH",
- "exceptionDesc": "After Hours",
- "exceptionComment": "DAMAGED PRODUCT/TOTE",
- "addedByName": "AH",
- "addedOn": "2022-03-25T10:30:00"
}
], - "cancellation": {
- "reasonCode": "ADR",
- "reasonDesc": "Invalid Address",
- "cancelDTTM": "2022-03-25T10:30:00",
- "cancelTimeZone": "GMT"
}
}
}
]
}
}
If the Static Route loadNbr/loadId exists then it will return the Static Route info.
companyCode required | string <= 50 characters Company code to which the Static Route belongs |
loadNbr | string <= 20 characters Example: loadNbr=STATICROUTE-1 Unique alphanumeric value used to refer a Static Route |
loadId | string <= 50 characters Example: loadId=abc124568sf79fhjf Unique alpha numeric system generated id used to refer a Static Route. Note: In query parameters either loadNbr or loadId is mandatory. |
{- "Load": {
- "loadHeader": {
- "loadId": "abcd123340707",
- "loadNbr": "Load_ND_1",
- "routeName": "Route-101",
- "earliestStartDttm": "2020-04-21T12:00:00",
- "latestStartDttm": "2020-04-21T16:00:00",
- "signatureRequired": true,
- "originAddr1": "1000 Circle 75 Pkwy",
- "originAddr2": "Villa Chase Drive",
- "originCity": "Atlanta",
- "originState": "GA",
- "originZip": 30339,
- "originCountry": "US",
- "origin": "nuVizz",
- "originName": "nuVizz Inc",
- "originPhoneNumber": 4073241456,
- "loadTimeZone": "US/Eastern",
- "originLatitude": 37.998789,
- "originLongitude": -87.788786,
- "rtOrigin": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "depot": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "facility": {
- "facilityId": "63426ffabc35656",
- "label": "East Region Office"
}, - "masterBol": "567BGH",
- "pronbr": "PRO2392382",
- "reference": "123a1",
- "reference2": "123a2",
- "reference3": "123a3",
- "sealNbr": "SN123",
- "stopSeqOrder": "1",
- "totalCartons": "10",
- "totalPallets": "8",
- "tractorNbr": "123TriNBR",
- "trailerNbr": "234TRCNBR",
- "trailerSize": "full or partial",
- "trailerType": "TrailerType",
- "vehicleType": "Box truck",
- "volume": 3000,
- "volumeUOM": "CU.FT.",
- "weight": 244,
- "weightUOM": "LBS",
- "contractCode": 1,
- "cusAccNbr": "UTE123",
- "cusBillAmt": 35.25,
- "profile": "Electronics",
- "prePlannedLoadDistance": 34.4,
- "prePlannedLoadDuration": 3.5,
- "returnToDepot": "ALWAYS",
- "delayReasonCode": 11,
- "delayReasonCodeComment": "Delay due to traffic congestion",
- "workType": "CustomerSurveyForm",
- "congestionFactor": 1.9,
- "sourceType": "INTG/USER",
- "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "assignedBillAmt": "123.25",
- "stagingLocation": "stage-1",
- "plannedETAWindow": "30",
- "maxRouteTime": "30",
- "shiftType": "FIXED",
- "maxDistMiles": "123.25",
- "cutOffTime": "2020-04-21T12:00:00"
}, - "loadExecutionInfo": {
- "loadStatus": 90,
- "actualStartDTTM": "2020-04-21T11:00:00",
- "actualStartTimeZone": "America/New_York",
- "actualEndDTTM": "2020-04-21T16:00:00",
- "actualEndTimeZone": "America/New_York",
- "plannedDistanceMiles": "13.72",
- "actualDistanceMiles": "12.72",
- "stopsOnRoute": "10",
- "stopsVisibleOnRoute": "3",
- "plannedDuration": 20.12,
- "actualDuration": 20.12
}, - "loadAssignment": {
- "carrierCode": "XYZBP",
- "assignmentCriteria": 1,
- "driverCdl": 98724890,
- "driverEmail": "driver1@test.com",
- "driverName": "John Smith",
- "driverUserName": "JohnSmith",
- "driverPhoneNumber": "string"
}, - "stops": [
- {
- "stop": {
- "stopId": "abcd123340707",
- "stopNbr": "Stop039",
- "stopSeq": "1",
- "stopType": "DO",
- "shipmentType": "REG",
- "company": {
- "code": "DCCOMP1",
- "name": "DC COMPANY"
}, - "visibility": [
- {
- "header": "string",
- "values": [
- "string"
]
}
], - "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": null,
- "signatoryName": null,
- "optional": null
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "to": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": null,
- "signatoryName": null,
- "optional": null
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "facility": {
- "facilityId": "63426ffabc35656",
- "label": "East Region Office"
}, - "invoiceRef": {
- "reference1": "Invoice Reference 1",
- "reference2": "Invoice Reference 2",
- "reference3": "Invoice Reference 3",
- "reference4": "Invoice Reference 4"
}, - "shipForBP": "1163",
- "shipperCode": "S201",
- "profile": "Electronics",
- "templateId": "abcd123340707",
- "consAttribute": "DNCA26R1S1021820",
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "shipmentNbr": "ShipmentNbr003",
- "receiveStatus": 3,
- "doConfirmation": "01",
- "puConfirmation": "00",
- "hubId": "LM1",
- "trailerCode": "tc2",
- "vehicleTypes": [
- "BOX",
- "TRUCK"
], - "accountNumber": "ACC01",
- "billTo": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "bol": "MBOL39203",
- "freightTerms": "new DC",
- "proNumber": "TC123",
- "reference1": "TCS1001",
- "reference2": "TCS1002",
- "sealNbr": 1,
- "stopPriority": 1,
- "totalCartons": "10",
- "totalPallets": "8",
- "volume": "10",
- "volumeUOM": "CBM",
- "weight": "100",
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "markAsReceived": true,
- "createdDttm": "2001-12-31T12:00:00",
- "receivedDttm": "2001-12-31T12:00:00",
- "laneNumber": "L1",
- "deliveryAttempt": 1,
- "altStopSeq": "A10",
- "stopGeofenceRadius": 150,
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "totalPrice": "123.85",
- "sourceType": "INTG/USER",
- "stopAccessorials": [
- {
- "code": "ACC",
- "comments": "ACC report for Stop",
- "type": "DO",
- "calcUnits": 10,
- "matchUnits": 25
}
], - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": "1",
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "palletID": "235AZRFTG",
- "orderDate": "2019-12-10",
- "toteID": 132245565,
- "trailerCode": "tcl",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "deliveryType": "DO",
- "customerPO": "100PO",
- "custRouteNbr": 151,
- "custStopNbr": 135,
- "customerOrderNbr": 124234356,
- "invoiceNbr": 102345001,
- "invoiceDate": "2019-12-09",
- "pickingNumber": "904729",
- "accountNumber": "ACC01",
- "confirmationType": "P",
- "lineType": 1,
- "referenceText": "Fragile item",
- "originalLineNumber": "10",
- "serviceCategory": "UNITS@20151021-0047-PALLET_1-003",
- "volume": "10",
- "volumeUOM": "cubic meters",
- "weight": "100",
- "weightUOM": "kilograms",
- "unitPrice": 40.1,
- "productCategory": "DRY",
- "productSubCategory": "Boxes & Trays",
- "substituteItem": true,
- "commitmentItem": true,
- "redelivery": true,
- "earliestDTTM": "2019-03-25T10:30:00",
- "latestDTTM": "2019-03-25T10:33:00",
- "length": "123.85",
- "lengthUOM": "inch",
- "width": "123.85",
- "widthUOM": "inch",
- "height": "123.85",
- "heightUOM": "inch",
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "consAttribute": "DNCA26R1S1021820",
- "collectSerialNbr": "GS1",
- "originCode": "AF2EA",
- "originName": "GS1 ATLANTA",
- "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "cartonContents": [
- {
- "itemId": "string",
- "description": "string",
- "toteId": "TCS1002",
- "qty": 0,
- "quantityUOM": "Cartons",
- "weight": "100",
- "weightUOM": "Kg",
- "reference1": "TCS1001",
- "reference2": "string",
- "shipperOrderNumber": "string",
- "custOrderNumber": "string",
- "customerComments": "In-valid details"
}
], - "confirmed": {
- "confirmedQty": "28",
- "scannedQty": "28",
- "puConfirmedQty": "28",
- "puScannedQty": "28",
- "exceptionReasonCode": "DMG",
- "exceptionComments": "Packing was damaged",
- "rcvQty": "28",
- "rcvScndQty": "28"
}
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "privateNotes": [
- {
- "userName": null,
- "description": "Stop Deliver to Cumberland Mall",
- "addedBy": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "stopAssignment": {
- "carrierCode": "XYZBP",
- "carrierName": "XYZBP"
}, - "planningType": "MANUAL",
- "routeProfile": {
- "id": "65b76331e6d05c080d1d11a4",
- "name": "Route Profile A"
}, - "assignedBillAmt": "123.25",
- "apptInfo": {
- "apptId": "345253",
- "apptStatus": "SCHEDULED",
- "apptDate": "2023-09-21",
- "startTime": "09:30",
- "endTime": "15:00",
- "comment": "Delivery timigs are strict"
}, - "trackingInfo": {
- "trackingEnabled": true,
- "trackingURL": "URL"
}, - "srvcLevel": "inch",
- "callerInfo": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "dispatcherInfo": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "estimationInfo": {
- "charges": [
- {
- "legNbr": "PU-FAC1",
- "contractId": "abcdefabcdef23248234",
- "assignedBillAmt": 234.2,
- "rateConfigEstimates": [
- {
- "code": null,
- "guid": null,
- "rateAmt": null
}
]
}
]
}
}, - "stopExecutionInfo": {
- "stopStatus": "10",
- "receiveStatus": "st",
- "receiveDTTM": "2022-03-25T10:30:00",
- "from": {
- "plannedEtaDTTM": "2022-03-25T10:30:00",
- "etaDttm": "2022-03-25T10:30:00",
- "arrivalDTTM": "2022-03-25T10:30:00",
- "confirmedDTTM": "2022-03-25T10:30:00",
- "departureDTTM": "2022-03-25T10:30:00",
- "duration": 22,
- "etaCode": "string",
- "podDoc": [
- {
- "createdTime": "2022-03-25T10:30:00",
- "documentName": "Cumberland Mall Delivery",
- "documentPath": "/path/to/document.pdf",
- "documentGuid": "123e4567-e89b-12d3-a456-426614174000",
- "extension": "pdf"
}
]
}, - "to": {
- "plannedEtaDTTM": "2022-03-25T10:30:00",
- "etaDttm": "2022-03-25T10:30:00",
- "arrivalDTTM": "2022-03-25T10:30:00",
- "confirmedDTTM": "2022-03-25T10:30:00",
- "departureDTTM": "2022-03-25T10:30:00",
- "duration": 22,
- "etaCode": "string",
- "podDoc": [
- {
- "createdTime": "2022-03-25T10:30:00",
- "documentName": "Cumberland Mall Delivery",
- "documentPath": "/path/to/document.pdf",
- "documentGuid": "123e4567-e89b-12d3-a456-426614174000",
- "extension": "pdf"
}
]
}, - "exceptionPresent": true,
- "exceptions": [
- {
- "exceptionCode": "AH",
- "exceptionDesc": "After Hours",
- "exceptionComment": "DAMAGED PRODUCT/TOTE",
- "addedByName": "AH",
- "addedOn": "2022-03-25T10:30:00"
}
], - "cancellation": {
- "reasonCode": "ADR",
- "reasonDesc": "Invalid Address",
- "cancelDTTM": "2022-03-25T10:30:00",
- "cancelTimeZone": "GMT"
}
}
}
], - "schedule": {
- "daysOfWeek": "MT",
- "enabled": "ACTIVE"
}
}
}
Imports the load in asynchronous mode.
serviceName required | string <= 100 characters serviceName refer to custom integration for the company, set to "default" if not using a custom integration |
companyCode required | string <= 50 characters Company Code to which the Load belongs to |
importRequest
companyCode required | string <= 20 characters CompanyCode from application |
required | Array of objects (Loads) <= 500 items |
{- "companyCode": "XYZ",
- "loads": [
- {
- "loadHeader": {
- "loadNbr": "Load_PB_911",
- "earliestStartDttm": "2001-12-31T12:00:00",
- "latestStartDttm": "2001-12-31T12:00:00",
- "signatureRequired": true,
- "originAddr1": "1000 Circle 75 Pkwy",
- "originAddr2": "Suite#700",
- "originCity": "Atlanta",
- "originState": "GA",
- "originZip": "30339",
- "originCountry": "US",
- "origin": "Nuvizz",
- "originName": "Nuvizz Inc",
- "originPhoneNumber": "4049371971",
- "loadTimeZone": "EST",
- "originLatitude": 0,
- "originLongitude": 0,
- "depot": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}
}, - "masterBol": "001",
- "pronbr": "002",
- "reference": "112345",
- "reference2": "456789",
- "reference3": "123456",
- "sealNbr": "01",
- "stopSeqOrder": 1,
- "totalCartons": 1,
- "totalPallets": 1,
- "tractorNbr": "54331",
- "trailerNbr": "12 I 45",
- "trailerSize": 456,
- "trailerType": 456,
- "vehicleType": "Box truck",
- "volume": 10,
- "volumeUOM": "CBM",
- "weight": 100,
- "weightUOM": "Kg",
- "contractCode": "007",
- "prePlannedLoadDistance": 10,
- "prePlannedLoadDuration": 10,
- "congestionFactor": 1.9,
- "comments": [
- {
- "commentType": "01",
- "commentDescription": "Load is deliver to multiple customer"
}, - {
- "commentType": "01",
- "commentDescription": "Get signature for load"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}, - {
- "keyField": "Cost",
- "keyValue": "High"
}
], - "documents": [
- {
- "description": "BOL",
- "dispositionType": 11,
- "documentData": "binday file data",
- "documentExtType": "pdf",
- "documentName": "Load BOL",
- "documentType": 1,
- "documentCategory": "FADR",
- "reference": "dc9382ee-3fdb-4d93-ad15-863ddde9eaea",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": 0
}
]
}
]
}, - "stops": [
- {
- "stopNbr": "Stop001",
- "stopSeq": 1,
- "stopType": "DO",
- "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "seq": 1,
- "txnRef": 40283,
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "XXXX",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "to": {
- "address": {
- "name": "Test-Stop",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "txnRef": 40224,
- "seq": 2,
- "contact": {
- "contactName": "Test-Stop",
- "email": "mike123@test.com",
- "phone": "4049371973",
- "sms": "4049371973"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "documents": [
- {
- "description": "BOL",
- "dispositionType": 11,
- "documentData": "binday file data",
- "documentExtType": "pdf",
- "documentName": "Load BOL",
- "documentType": 1,
- "documentCategory": "FADR",
- "reference": "dc9382ee-3fdb-4d93-ad15-863ddde9eaea",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": 0
}
]
}
], - "workType": "CustomerSurvey",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "shipmentNbr": "ShipmentNbr001",
- "accountNumber": 1,
- "billTo": {
- "name": "test",
- "addr1": "1001 NOrth Taylor Road",
- "addr2": null,
- "city": "Rome",
- "state": "IL",
- "zip": "60446",
- "country": "US",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "bol": "BOL001",
- "markfor": {
- "address": {
- "name": "KAISER PERM MAIL ORDER PHCY",
- "addr1": "5725 NE 138th Ave",
- "addr2": "",
- "city": "Portland",
- "state": "OR",
- "zip": "97230",
- "country": "USA",
- "landmark": "",
- "latitude": "",
- "longitude": ""
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "",
- "phone": "",
- "sms": ""
}
}, - "freightTerms": 1,
- "proNumber": 7549357,
- "reference1": "9753AHB",
- "reference2": "9024DCK",
- "sealNbr": 1,
- "stopPriority": 1,
- "totalCartons": 1,
- "totalPallets": 1,
- "puConfirmation": "SKIP",
- "doConfirmation": "SCAN-VER",
- "volume": 10,
- "volumeUOM": "CBM",
- "weight": 100,
- "weightUOM": "Kg",
- "vehicleTypes": [
- "BOX",
- "TRUCK"
], - "scheduleAttribute": "NA",
- "markAsReceived": false,
- "receivedDttm": "2001-12-31T12:00:00",
- "laneNumber": "01",
- "deliveryAttempt": 0,
- "altStopSeq": 200,
- "stopGeofenceRadius": 10,
- "profile": "Electronics",
- "stopAccessorials": [
- {
- "code": "RDE",
- "comments": "ACC"
}
], - "stopDetails": [
- {
- "product": "SK-1932A-BRN-2",
- "productIdentifier": "708107210227582969",
- "quantity": 1,
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "deliveryType": "PU",
- "pickingNumber": 1,
- "accountNumber": "ACC01",
- "confirmationType": "P",
- "lineType": "01",
- "referenceText": "Fragile item",
- "originalLineNumber": "21",
- "serviceCategory": "UNITS@20151021-0047-PALLET_1-003",
- "volume": 10,
- "volumeUOM": "CBM",
- "weight": 100,
- "weightUOM": "Kg",
- "unitPrice": 0,
- "productCategory": "DRY",
- "productSubCategory": "Boxes & Trays",
- "substituteItem": true,
- "commitmentItem": true,
- "redelivery": true,
- "collectSerialNbr": "GS1",
- "originCode": "AF2EA",
- "originName": "GS1 ATLANTA",
- "markfor": {
- "address": {
- "name": "KAISER PERM MAIL ORDER PHCY",
- "addr1": "5725 NE 138th Ave",
- "addr2": "",
- "city": "Portland",
- "state": "OR",
- "zip": "97230",
- "country": "USA",
- "landmark": "",
- "latitude": "",
- "longitude": ""
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "",
- "phone": "",
- "sms": ""
}
}, - "comments": [
- {
- "commentType": "01",
- "commentDescription": "This item is Fragile handel with care"
}
]
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}, - {
- "keyField": "Cost",
- "keyValue": "High"
}
]
}
], - "loadAssignment": {
- "carrierCode": "XYZBP",
- "assignmentCriteria": 1,
- "driverCdl": 98724890,
- "driverEmail": "driver12@test.com",
- "driverName": "admin",
- "driverUserName": "driver"
}
}
]
}
{- "status": "Success"
}
Imports the Static Route in synchronous mode.
companyCode required | string <= 50 characters Company Code to which the Static Route belongs to |
importRequest
companyCode required | string <= 20 characters CompanyCode from application |
required | Array of objects (StaticRoutes) <= 500 items |
{- "companyCode": "1181",
- "loads": [
- {
- "loadHeader": {
- "loadNbr": "W59-NUDEL012944",
- "earliestStartDttm": "2020-08-03T08:52:00",
- "latestStartDttm": "2020-08-03T09:52:00",
- "originAddr1": "13823 NE Airport Way",
- "originAddr2": "",
- "originCity": "Portland",
- "originState": "OR",
- "originZip": "97230",
- "originCountry": "USA",
- "origin": "1181",
- "originName": "Portland",
- "loadTimeZone": "GMT",
- "returnToDepot": "ALWAYS",
- "congestionFactor": 1.9
}, - "stops": [
- {
- "stopNbr": "3011",
- "stopSeq": 1,
- "stopType": "DO",
- "bol": "W59-235",
- "consAttribute": "030LH6X50100055270R080320",
- "profile": "Electronics",
- "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "XXXX",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "to": {
- "address": {
- "name": "Test-Stop",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "mike123@test.com",
- "phone": "4049371973",
- "sms": "4049371973"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "CustomerSurvey",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "billTo": {
- "name": "test",
- "addr1": "1001 NOrth Taylor Road",
- "addr2": null,
- "city": "Rome",
- "state": "IL",
- "zip": "60446",
- "country": "US",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "puConfirmation": "SKIP",
- "doConfirmation": "SCAN-VER",
- "markfor": {
- "address": {
- "name": "KAISER PERM MAIL ORDER PHCY",
- "addr1": "5725 NE 138th Ave",
- "addr2": "",
- "city": "Portland",
- "state": "OR",
- "zip": "97230",
- "country": "USA",
- "landmark": "",
- "latitude": "",
- "longitude": ""
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "",
- "phone": "",
- "sms": ""
}
}, - "stopDetails": [
- {
- "product": 30987010019882480,
- "productCategory": "COLTOTS",
- "deliveryType": "DO",
- "quantity": 1,
- "quantityUOM": "CTN",
- "productIdentifier": 30987010019882480,
- "stopDetailSeq": 1,
- "referenceText": "Required",
- "collectSerialNbr": "GS1",
- "markfor": {
- "address": {
- "name": "KAISER PERM MAIL ORDER PHCY",
- "addr1": "5725 NE 138th Ave",
- "addr2": "",
- "city": "Portland",
- "state": "OR",
- "zip": "97230",
- "country": "USA",
- "landmark": "",
- "latitude": "",
- "longitude": ""
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "",
- "phone": "",
- "sms": ""
}
}, - "custRouteNbr": "X50",
- "custStopNbr": "3011",
- "customerPO": "106010000030409",
- "customerOrderNbr": "4441910810",
- "orderDate": "2017-01-02T00:00:00Z",
- "invoiceNbr": "911694079",
- "invoiceDate": "2017-01-03T00:00:00Z",
- "toteID": "20007222003",
- "trailerCode": "LH6",
- "ratingGroup": "100055270R",
- "signatureGroup": "",
- "palletID": "T07222016",
- "earliestDTTM": "2020-08-03T13:30:00",
- "latestDTTM": "2020-08-03T13:31:00",
- "consAttribute": "030LH6X50100055270R080320",
- "pickingNumber": "1189",
- "accountNumber": "0100055270"
}, - {
- "product": 30987010019882500,
- "productCategory": "STOTE",
- "deliveryType": "DO",
- "quantity": 1,
- "quantityUOM": "CTN",
- "productIdentifier": 30987010019882500,
- "stopDetailSeq": 2,
- "referenceText": "Not Required",
- "collectSerialNbr": "GS1",
- "markfor": {
- "address": {
- "name": "KAISER PERM MAIL ORDER PHCY",
- "addr1": "5725 NE 138th Ave",
- "addr2": "",
- "city": "Portland",
- "state": "OR",
- "zip": "97230",
- "country": "USA",
- "landmark": "",
- "latitude": "",
- "longitude": ""
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "",
- "phone": "",
- "sms": ""
}
}, - "custRouteNbr": "X50",
- "custStopNbr": "3011",
- "customerPO": "106010000030409",
- "customerOrderNbr": "4441910810",
- "orderDate": "2017-01-02T00:00:00Z",
- "invoiceNbr": "911694079",
- "invoiceDate": "2017-01-03T00:00:00Z",
- "toteID": "20007222002",
- "trailerCode": "LH6",
- "ratingGroup": "100055270R",
- "signatureGroup": "",
- "palletID": "T07222016",
- "earliestDTTM": "2020-08-03T13:30:00",
- "latestDTTM": "2020-08-03T13:31:00",
- "consAttribute": "030LH6X50100055270R080320",
- "pickingNumber": "1189",
- "accountNumber": "0100055270"
}, - {
- "product": 30987010019882504,
- "productCategory": "STOTE",
- "deliveryType": "DO",
- "quantity": 1,
- "quantityUOM": "CTN",
- "productIdentifier": 30987010019882504,
- "stopDetailSeq": 3,
- "referenceText": "Not Required",
- "collectSerialNbr": "GS1",
- "markfor": {
- "address": {
- "name": "KAISER PERM MAIL ORDER PHCY",
- "addr1": "5725 NE 138th Ave",
- "addr2": "",
- "city": "Portland",
- "state": "OR",
- "zip": "97230",
- "country": "USA",
- "landmark": "",
- "latitude": "",
- "longitude": ""
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "",
- "phone": "",
- "sms": ""
}
}, - "custRouteNbr": "X50",
- "custStopNbr": "3011",
- "customerPO": "106010000030409",
- "customerOrderNbr": "4441910810",
- "orderDate": "2017-01-02T00:00:00Z",
- "invoiceNbr": "911694080",
- "invoiceDate": "2017-01-03T00:00:00Z",
- "toteID": "20007222003",
- "trailerCode": "LH6",
- "ratingGroup": "100055270R",
- "signatureGroup": null,
- "palletID": "T07222016",
- "earliestDTTM": "2020-08-03T13:30:00",
- "latestDTTM": "2020-08-03T13:31:00",
- "consAttribute": "030LH6X50100055270R080320",
- "pickingNumber": "1189",
- "accountNumber": "0100055270"
}, - {
- "product": 30987010019882510,
- "productCategory": "COLTOTS",
- "deliveryType": "DO",
- "quantity": 1,
- "quantityUOM": "CTN",
- "productIdentifier": 30987010019882510,
- "stopDetailSeq": 4,
- "referenceText": "Required",
- "collectSerialNbr": "GS1",
- "markfor": {
- "address": {
- "name": "KAISER PERM MAIL ORDER PHCY",
- "addr1": "5725 NE 138th Ave",
- "addr2": "",
- "city": "Portland",
- "state": "OR",
- "zip": "97230",
- "country": "USA",
- "landmark": "",
- "latitude": "",
- "longitude": ""
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "",
- "phone": "",
- "sms": ""
}
}, - "custRouteNbr": "X50",
- "custStopNbr": "3011",
- "customerPO": "106010000030409",
- "customerOrderNbr": "4441910810",
- "orderDate": "2017-01-02T00:00:00Z",
- "invoiceNbr": "911694079",
- "invoiceDate": "2017-01-03T00:00:00Z",
- "toteID": "20007222004",
- "trailerCode": "LH6",
- "ratingGroup": "100055270R",
- "signatureGroup": null,
- "palletID": "T07222016",
- "earliestDTTM": "2020-08-03T13:30:00",
- "latestDTTM": "2020-08-03T13:31:00",
- "consAttribute": "030LH6X50100055270R080320",
- "pickingNumber": "1190",
- "accountNumber": "0100055270"
}, - {
- "product": 30987010019882530,
- "productCategory": "STOTE",
- "deliveryType": "DO",
- "quantity": 1,
- "quantityUOM": "CTN",
- "productIdentifier": 30987010019882530,
- "stopDetailSeq": 5,
- "referenceText": "Not Required",
- "collectSerialNbr": "GS1",
- "markfor": {
- "address": {
- "name": "KAISER PERM MAIL ORDER PHCY",
- "addr1": "5725 NE 138th Ave",
- "addr2": "",
- "city": "Portland",
- "state": "OR",
- "zip": "97230",
- "country": "USA",
- "landmark": "",
- "latitude": "",
- "longitude": ""
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "",
- "phone": "",
- "sms": ""
}
}, - "custRouteNbr": "X50",
- "custStopNbr": "3011",
- "customerPO": "106010000030409",
- "customerOrderNbr": "4441910810",
- "orderDate": "2017-01-02T00:00:00Z",
- "invoiceNbr": "911694079",
- "invoiceDate": "2017-01-03T00:00:00Z",
- "toteID": "20007222005",
- "trailerCode": "LH6",
- "ratingGroup": "100055270R",
- "signatureGroup": null,
- "palletID": "T07222016",
- "earliestDTTM": "2020-08-03T13:30:00",
- "latestDTTM": "2020-08-03T13:31:00",
- "consAttribute": "030LH6X50100055270R080320",
- "pickingNumber": "1190",
- "accountNumber": "0100055270"
}, - {
- "product": 30987010019882536,
- "productCategory": "STOTE",
- "deliveryType": "DO",
- "quantity": 1,
- "quantityUOM": "CTN",
- "productIdentifier": 30987010019882536,
- "stopDetailSeq": 6,
- "referenceText": "Not Required",
- "collectSerialNbr": "GS1",
- "markfor": {
- "address": {
- "name": "KAISER PERM MAIL ORDER PHCY",
- "addr1": "5725 NE 138th Ave",
- "addr2": "",
- "city": "Portland",
- "state": "OR",
- "zip": "97230",
- "country": "USA",
- "landmark": "",
- "latitude": "",
- "longitude": ""
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "",
- "phone": "",
- "sms": ""
}
}, - "custRouteNbr": "X50",
- "custStopNbr": "3011",
- "customerPO": "106010000030409",
- "customerOrderNbr": "4441910810",
- "orderDate": "2017-01-02T00:00:00Z",
- "invoiceNbr": "911694080",
- "invoiceDate": "2017-01-03T00:00:00Z",
- "toteID": "20007222006",
- "trailerCode": "LH6",
- "ratingGroup": "100055270R",
- "signatureGroup": null,
- "palletID": "T07222016",
- "earliestDTTM": "2020-08-03T13:30:00",
- "latestDTTM": "2020-08-03T13:31:00",
- "consAttribute": "030LH6X50100055270R080320",
- "pickingNumber": "1190",
- "accountNumber": "0100055270"
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Comment Description"
}
]
}, - {
- "stopNbr": "3027",
- "stopSeq": 2,
- "stopType": "DO",
- "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "XXXX",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "to": {
- "address": {
- "name": "Test-Stop",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "mike123@test.com",
- "phone": "4049371973",
- "sms": "4049371973"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "CustomerSurvey",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "puConfirmation": "SKIP",
- "doConfirmation": "SCAN-VER",
- "shipmentNbr": "QuickConfirm",
- "profile": "Electronics"
}
], - "loadAssignment": {
- "carrierCode": "XYZBP",
- "assignmentCriteria": 1,
- "driverCdl": 98724890,
- "driverEmail": "driver12@test.com",
- "driverName": "admin",
- "driverUserName": "driver"
}
}
]
}
{- "status": "Success",
- "apiResult": {
- "created": 10,
- "updated": 10,
- "failed": 10,
- "deleted": 10,
- "errors": [
- {
- "key": "StopNbr123",
- "msgs": [
- "string"
]
}
]
}, - "reasons": [
- {
- "description": "Company Code is required.",
- "errorCode": 1505,
- "errorLiteral": "nuvizz_entity_error_xxyy"
}
]
}
Creates a recurring route from an existing route in the system in synchronous mode.
companyCode required | string <= 50 characters Company Code to which the route belongs |
importRequest
companyCode required | string <= 20 characters Company Code from the nuVizz application. |
routeId | string <= 50 characters Unique alphanumeric system generated id used to refer to a route. |
routeNbr required | string <= 20 characters The route number unique to the business. Represents a truck load. |
routeName required | string <= 20 characters The route name following the movement of goods. |
daysOfWeek required | string <= 7 characters List of days of week for preferred delivery
|
overrideExisting required | boolean Override an existing recurring route of the same name |
{- "companyCode": "1181",
- "routeNbr": "W59-NUDEL012944",
- "routeName": "W-59MONDAY",
- "daysOfWeek": "MW",
- "overrideExisting": true
}
{- "reasons": [
- {
- "description": "Company Code is required.",
- "reasonCode": 1505
}
]
}
Assign a Load to a Carrier/Bussiness Partner by specifying the CarrierCode of the carrier.
companyCode required | string <= 50 characters Company Code to which the Load belongs |
loadNbr required | string <= 100 characters Unique alpha numeric value used to refer a Load |
importRequest
carrierCode required | string <= 10 characters Load assigned carrier code. |
assignmentCriteria | string <= 10 characters It has a value 01 and when given so will look for the corresponding carrier code and assign the Load to available driver of that carrier. |
{- "carrierCode": "XYZBP",
- "assignmentCriteria": "01"
}
{- "status": "Success"
}
Unassign a Load from the Carrier/BusinessPartner
companyCode required | string <= 50 characters Company Code of the Load/Route Owner |
loadNbr required | string <= 100 characters Unique alpha numeric value used to refer a Load |
importRequest
carrierCode required | string <= 10 characters Load assigned carrier code. |
assignmentCriteria | string <= 10 characters It has a value 01 and when given so will look for the corresponding carrier code and assign the Load to available driver of that carrier. |
{- "carrierCode": "XYZBP",
- "assignmentCriteria": "01"
}
{- "status": "Success"
}
Assign a Load to a driver
companyCode required | string <= 50 characters Company Code of Load/Route |
loadNbr | string <= 100 characters Unique alpha numeric value used to refer a Load. |
loadId | string <= 50 characters Unique alphanumeric Id generated in nuDeliverit system to refer specific Load. Note: In query parameters either loadNbr or loadId is mandatory. |
driverEmail | string <= 50 characters Email ID of Driver assigned. |
driverUserName | string <= 100 characters Refers to Driver User Name. Note: In query parameters either driverEmail or driverUserName is mandatory. |
{- "reasons": [
- {
- "description": "Company Code is required.",
- "reasonCode": 1505
}
]
}
Unassigning a a Load from a Driver
companyCode required | string <= 50 characters Company Code of Load/Route |
loadNbr | string <= 100 characters Unique alpha numeric value used to refer a Load. |
loadId | string <= 50 characters Unique alphanumeric Id generated in nuDeliverit system to refer specific Load. Note: In query parameters either loadNbr or loadId is mandatory. |
{- "reasons": [
- {
- "description": "Company Code is required.",
- "reasonCode": 1505
}
]
}
Delete/Reject a Load that is unassigned from a Driver and move it to cancelled status
companyCode required | string <= 50 characters Company Code of Load/Route |
loadNbr | string <= 20 characters Unique alphanumeric value that refers to a Load. |
loadId | string <= 40 characters Alphanumeric unique system generated id used to refer the load you want to assign the driver Note: parameters loadNbr or loadId is mandatory. |
reasonCode required | string <= 10 characters reasonCode is the system code that refers to a particular reaon for canceling the Load. |
reasonComments | string <= 500 characters Comments included when canceling the Load. |
{- "loadNbr": "L1230001",
- "loadId": "234544sadec0000000a23451",
- "reasonCode": "01",
- "reasonComments": "Duplicated orders on this Load"
}
{- "reasons": [
- {
- "description": "Company Code is required.",
- "reasonCode": 1505
}
]
}
Details of a Stop/Order which is usually the product name, quantity, capacity constraints etc.
companyCode required | string <= 50 characters Company Code of Stop |
stopNbr required | string <= 100 characters Unique alpha numeric value used to refer a Stop/Order |
// Import classes: import com.nuvizz.openapi.inbound.handler.ApiClient; import com.nuvizz.openapi.inbound.handler.ApiException; import com.nuvizz.openapi.inbound.handler.Configuration; import com.nuvizz.openapi.inbound.handler.auth.*; import com.nuvizz.openapi.inbound.handler.models.*; import com.nuvizz.openapi.inbound.handler.LoadApiApi; public class Example { public static void main(String[] args) { ApiClient defaultClient = Configuration.getDefaultApiClient(); defaultClient.setBasePath("https://contact-support.nuvizz.com/api-gateway/webservices/nudeliverit/v5"); // Configure HTTP basic authorization: Basic Authentication HttpBasicAuth Basic Authentication = (HttpBasicAuth) defaultClient.getAuthentication("Basic Authentication"); Basic Authentication.setUsername("YOUR USERNAME"); Basic Authentication.setPassword("YOUR PASSWORD"); StopApiApi apiInstance = new StopApiApi(defaultClient); String companyCode = "companyCode_example"; // String | Company Code of Stop String stopNbr = "stopNbr_example"; // String | Unique alpha numeric value used to refer a Stop/Order try { StopInfoSuccessResponse result = apiInstance.getStopDetail(companyCode, stopNbr); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling StopApiApi#getStopDetail"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } }
{- "Stop": {
- "stop": {
- "stopId": "abcd123340707",
- "stopNbr": "Stop039",
- "stopSeq": "1",
- "stopType": "DO",
- "shipmentType": "REG",
- "company": {
- "code": "DCCOMP1",
- "name": "DC COMPANY"
}, - "visibility": [
- {
- "header": "string",
- "values": [
- "string"
]
}
], - "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "to": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "facility": {
- "facilityId": "63426ffabc35656",
- "label": "East Region Office"
}, - "invoiceRef": {
- "reference1": "Invoice Reference 1",
- "reference2": "Invoice Reference 2",
- "reference3": "Invoice Reference 3",
- "reference4": "Invoice Reference 4"
}, - "shipForBP": "1163",
- "shipperCode": "S201",
- "profile": "Electronics",
- "templateId": "abcd123340707",
- "consAttribute": "DNCA26R1S1021820",
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "shipmentNbr": "ShipmentNbr003",
- "receiveStatus": 3,
- "doConfirmation": "01",
- "puConfirmation": "00",
- "hubId": "LM1",
- "trailerCode": "tc2",
- "vehicleTypes": [
- "BOX",
- "TRUCK"
], - "accountNumber": "ACC01",
- "billTo": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "bol": "MBOL39203",
- "freightTerms": "new DC",
- "proNumber": "TC123",
- "reference1": "TCS1001",
- "reference2": "TCS1002",
- "sealNbr": 1,
- "stopPriority": 1,
- "totalCartons": "10",
- "totalPallets": "8",
- "volume": "10",
- "volumeUOM": "CBM",
- "weight": "100",
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "markAsReceived": true,
- "createdDttm": "2001-12-31T12:00:00",
- "receivedDttm": "2001-12-31T12:00:00",
- "laneNumber": "L1",
- "deliveryAttempt": 1,
- "altStopSeq": "A10",
- "stopGeofenceRadius": 150,
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "totalPrice": "123.85",
- "sourceType": "INTG/USER",
- "stopAccessorials": [
- {
- "code": "ACC",
- "comments": "ACC report for Stop",
- "type": "DO",
- "calcUnits": 10,
- "matchUnits": 25
}
], - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": "1",
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "palletID": "235AZRFTG",
- "orderDate": "2019-12-10",
- "toteID": 132245565,
- "trailerCode": "tcl",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "deliveryType": "DO",
- "customerPO": "100PO",
- "custRouteNbr": 151,
- "custStopNbr": 135,
- "customerOrderNbr": 124234356,
- "invoiceNbr": 102345001,
- "invoiceDate": "2019-12-09",
- "pickingNumber": "904729",
- "accountNumber": "ACC01",
- "confirmationType": "P",
- "lineType": 1,
- "referenceText": "Fragile item",
- "originalLineNumber": "10",
- "serviceCategory": "UNITS@20151021-0047-PALLET_1-003",
- "volume": "10",
- "volumeUOM": "cubic meters",
- "weight": "100",
- "weightUOM": "kilograms",
- "unitPrice": 40.1,
- "productCategory": "DRY",
- "productSubCategory": "Boxes & Trays",
- "substituteItem": true,
- "commitmentItem": true,
- "redelivery": true,
- "earliestDTTM": "2019-03-25T10:30:00",
- "latestDTTM": "2019-03-25T10:33:00",
- "length": "123.85",
- "lengthUOM": "inch",
- "width": "123.85",
- "widthUOM": "inch",
- "height": "123.85",
- "heightUOM": "inch",
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "consAttribute": "DNCA26R1S1021820",
- "collectSerialNbr": "GS1",
- "originCode": "AF2EA",
- "originName": "GS1 ATLANTA",
- "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "cartonContents": [
- {
- "itemId": "string",
- "description": "string",
- "toteId": "TCS1002",
- "qty": 0,
- "quantityUOM": "Cartons",
- "weight": "100",
- "weightUOM": "Kg",
- "reference1": "TCS1001",
- "reference2": "string",
- "shipperOrderNumber": "string",
- "custOrderNumber": "string",
- "customerComments": "In-valid details"
}
], - "confirmed": {
- "confirmedQty": "28",
- "scannedQty": "28",
- "puConfirmedQty": "28",
- "puScannedQty": "28",
- "exceptionReasonCode": "DMG",
- "exceptionComments": "Packing was damaged",
- "rcvQty": "28",
- "rcvScndQty": "28"
}
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "privateNotes": [
- {
- "userName": null,
- "description": "Stop Deliver to Cumberland Mall",
- "addedBy": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "stopAssignment": {
- "carrierCode": "XYZBP",
- "carrierName": "XYZBP"
}, - "planningType": "MANUAL",
- "routeProfile": {
- "id": "65b76331e6d05c080d1d11a4",
- "name": "Route Profile A"
}, - "assignedBillAmt": "123.25",
- "apptInfo": {
- "apptId": "345253",
- "apptStatus": "SCHEDULED",
- "apptDate": "2023-09-21",
- "startTime": "09:30",
- "endTime": "15:00",
- "comment": "Delivery timigs are strict"
}, - "trackingInfo": {
- "trackingEnabled": true,
- "trackingURL": "URL"
}, - "srvcLevel": "inch",
- "callerInfo": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "dispatcherInfo": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "estimationInfo": {
- "charges": [
- {
- "legNbr": "PU-FAC1",
- "contractId": "abcdefabcdef23248234",
- "assignedBillAmt": 234.2,
- "rateConfigEstimates": [
- {
- "code": "RT_v1",
- "guid": "abcdcdfgh",
- "rateAmt": 234.2
}
]
}
]
}
}, - "load": {
- "loadNbr": "ROUTE02390",
- "loadId": "234544sadec0000000a23451",
- "loadStatus": "01",
- "routeName": "Route-101",
- "routeStartDTTM": "2020-04-21T12:00:00",
- "departedDTTM": "2020-04-21T12:00:00",
- "driverName": "John Smith",
- "driverId": 123,
- "driverPhoneNum": "string",
- "vehicleNbr": "vehicle1",
- "vehicleType": "Truck",
- "createdDttm": "2001-12-31T12:00:00"
}, - "stopExecutionInfo": {
- "stopStatus": "10",
- "receiveStatus": "st",
- "receiveDTTM": "2022-03-25T10:30:00",
- "from": {
- "plannedEtaDTTM": "2022-03-25T10:30:00",
- "etaDttm": "2022-03-25T10:30:00",
- "arrivalDTTM": "2022-03-25T10:30:00",
- "confirmedDTTM": "2022-03-25T10:30:00",
- "departureDTTM": "2022-03-25T10:30:00",
- "duration": 22,
- "etaCode": "string",
- "podDoc": [
- {
- "createdTime": "2022-03-25T10:30:00",
- "documentName": "Cumberland Mall Delivery",
- "documentPath": "/path/to/document.pdf",
- "documentGuid": "123e4567-e89b-12d3-a456-426614174000",
- "extension": "pdf"
}
]
}, - "to": {
- "plannedEtaDTTM": "2022-03-25T10:30:00",
- "etaDttm": "2022-03-25T10:30:00",
- "arrivalDTTM": "2022-03-25T10:30:00",
- "confirmedDTTM": "2022-03-25T10:30:00",
- "departureDTTM": "2022-03-25T10:30:00",
- "duration": 22,
- "etaCode": "string",
- "podDoc": [
- {
- "createdTime": "2022-03-25T10:30:00",
- "documentName": "Cumberland Mall Delivery",
- "documentPath": "/path/to/document.pdf",
- "documentGuid": "123e4567-e89b-12d3-a456-426614174000",
- "extension": "pdf"
}
]
}, - "exceptionPresent": true,
- "exceptions": [
- {
- "exceptionCode": "AH",
- "exceptionDesc": "After Hours",
- "exceptionComment": "DAMAGED PRODUCT/TOTE",
- "addedByName": "AH",
- "addedOn": "2022-03-25T10:30:00"
}
], - "cancellation": {
- "reasonCode": "ADR",
- "reasonDesc": "Invalid Address",
- "cancelDTTM": "2022-03-25T10:30:00",
- "cancelTimeZone": "GMT"
}
}
}
}
Details of a Stop/Order which is usually the product name, quantity, capacity constraints etc.
companyCode required | string <= 50 characters Company Code which the Stop/Order belongs to. |
stopId required | string <= 50 characters Unique alpha numeric system generated id used to refer a Stop/Order |
excludeFields | Array of strings <= 10 items Example: excludeFields=stop_stopDetails&excludeFields=stop_estimationInfo Exclude the specified fields in the response like StopDetails, ExecutionInfo example: ["stop_stopDetails", "stop_estimationInfo"] |
{- "stop": {
- "stop": {
- "stopId": "abcd123340707",
- "stopNbr": "Stop039",
- "stopSeq": "1",
- "stopType": "DO",
- "shipmentType": "REG",
- "company": {
- "code": "DCCOMP1",
- "name": "DC COMPANY"
}, - "visibility": [
- {
- "header": "string",
- "values": [
- "string"
]
}
], - "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "to": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "facility": {
- "facilityId": "63426ffabc35656",
- "label": "East Region Office"
}, - "invoiceRef": {
- "reference1": "Invoice Reference 1",
- "reference2": "Invoice Reference 2",
- "reference3": "Invoice Reference 3",
- "reference4": "Invoice Reference 4"
}, - "shipForBP": "1163",
- "shipperCode": "S201",
- "profile": "Electronics",
- "templateId": "abcd123340707",
- "consAttribute": "DNCA26R1S1021820",
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "shipmentNbr": "ShipmentNbr003",
- "receiveStatus": 3,
- "doConfirmation": "01",
- "puConfirmation": "00",
- "hubId": "LM1",
- "trailerCode": "tc2",
- "vehicleTypes": [
- "BOX",
- "TRUCK"
], - "accountNumber": "ACC01",
- "billTo": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "bol": "MBOL39203",
- "freightTerms": "new DC",
- "proNumber": "TC123",
- "reference1": "TCS1001",
- "reference2": "TCS1002",
- "sealNbr": 1,
- "stopPriority": 1,
- "totalCartons": "10",
- "totalPallets": "8",
- "volume": "10",
- "volumeUOM": "CBM",
- "weight": "100",
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "markAsReceived": true,
- "createdDttm": "2001-12-31T12:00:00",
- "receivedDttm": "2001-12-31T12:00:00",
- "laneNumber": "L1",
- "deliveryAttempt": 1,
- "altStopSeq": "A10",
- "stopGeofenceRadius": 150,
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "totalPrice": "123.85",
- "sourceType": "INTG/USER",
- "stopAccessorials": [
- {
- "code": "ACC",
- "comments": "ACC report for Stop",
- "type": "DO",
- "calcUnits": 10,
- "matchUnits": 25
}
], - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": "1",
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "palletID": "235AZRFTG",
- "orderDate": "2019-12-10",
- "toteID": 132245565,
- "trailerCode": "tcl",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "deliveryType": "DO",
- "customerPO": "100PO",
- "custRouteNbr": 151,
- "custStopNbr": 135,
- "customerOrderNbr": 124234356,
- "invoiceNbr": 102345001,
- "invoiceDate": "2019-12-09",
- "pickingNumber": "904729",
- "accountNumber": "ACC01",
- "confirmationType": "P",
- "lineType": 1,
- "referenceText": "Fragile item",
- "originalLineNumber": "10",
- "serviceCategory": "UNITS@20151021-0047-PALLET_1-003",
- "volume": "10",
- "volumeUOM": "cubic meters",
- "weight": "100",
- "weightUOM": "kilograms",
- "unitPrice": 40.1,
- "productCategory": "DRY",
- "productSubCategory": "Boxes & Trays",
- "substituteItem": true,
- "commitmentItem": true,
- "redelivery": true,
- "earliestDTTM": "2019-03-25T10:30:00",
- "latestDTTM": "2019-03-25T10:33:00",
- "length": "123.85",
- "lengthUOM": "inch",
- "width": "123.85",
- "widthUOM": "inch",
- "height": "123.85",
- "heightUOM": "inch",
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "consAttribute": "DNCA26R1S1021820",
- "collectSerialNbr": "GS1",
- "originCode": "AF2EA",
- "originName": "GS1 ATLANTA",
- "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "cartonContents": [
- {
- "itemId": "string",
- "description": "string",
- "toteId": "TCS1002",
- "qty": 0,
- "quantityUOM": "Cartons",
- "weight": "100",
- "weightUOM": "Kg",
- "reference1": "TCS1001",
- "reference2": "string",
- "shipperOrderNumber": "string",
- "custOrderNumber": "string",
- "customerComments": "In-valid details"
}
], - "confirmed": {
- "confirmedQty": "28",
- "scannedQty": "28",
- "puConfirmedQty": "28",
- "puScannedQty": "28",
- "exceptionReasonCode": "DMG",
- "exceptionComments": "Packing was damaged",
- "rcvQty": "28",
- "rcvScndQty": "28"
}
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "privateNotes": [
- {
- "userName": null,
- "description": "Stop Deliver to Cumberland Mall",
- "addedBy": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "stopAssignment": {
- "carrierCode": "XYZBP",
- "carrierName": "XYZBP"
}, - "planningType": "MANUAL",
- "routeProfile": {
- "id": "65b76331e6d05c080d1d11a4",
- "name": "Route Profile A"
}, - "assignedBillAmt": "123.25",
- "apptInfo": {
- "apptId": "345253",
- "apptStatus": "SCHEDULED",
- "apptDate": "2023-09-21",
- "startTime": "09:30",
- "endTime": "15:00",
- "comment": "Delivery timigs are strict"
}, - "trackingInfo": {
- "trackingEnabled": true,
- "trackingURL": "URL"
}, - "srvcLevel": "inch",
- "callerInfo": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "dispatcherInfo": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "estimationInfo": {
- "charges": [
- {
- "legNbr": "PU-FAC1",
- "contractId": "abcdefabcdef23248234",
- "assignedBillAmt": 234.2,
- "rateConfigEstimates": [
- {
- "code": "RT_v1",
- "guid": "abcdcdfgh",
- "rateAmt": 234.2
}
]
}
]
}
}, - "load": {
- "loadNbr": "ROUTE02390",
- "loadId": "234544sadec0000000a23451",
- "loadStatus": "01",
- "routeName": "Route-101",
- "routeStartDTTM": "2020-04-21T12:00:00",
- "departedDTTM": "2020-04-21T12:00:00",
- "driverName": "John Smith",
- "driverId": 123,
- "driverPhoneNum": "string",
- "vehicleNbr": "vehicle1",
- "vehicleType": "Truck",
- "createdDttm": "2001-12-31T12:00:00"
}, - "stopExecutionInfo": {
- "stopStatus": "10",
- "receiveStatus": "st",
- "receiveDTTM": "2022-03-25T10:30:00",
- "from": {
- "plannedEtaDTTM": "2022-03-25T10:30:00",
- "etaDttm": "2022-03-25T10:30:00",
- "arrivalDTTM": "2022-03-25T10:30:00",
- "confirmedDTTM": "2022-03-25T10:30:00",
- "departureDTTM": "2022-03-25T10:30:00",
- "duration": 22,
- "etaCode": "string",
- "podDoc": [
- {
- "createdTime": "2022-03-25T10:30:00",
- "documentName": "Cumberland Mall Delivery",
- "documentPath": "/path/to/document.pdf",
- "documentGuid": "123e4567-e89b-12d3-a456-426614174000",
- "extension": "pdf"
}
]
}, - "to": {
- "plannedEtaDTTM": "2022-03-25T10:30:00",
- "etaDttm": "2022-03-25T10:30:00",
- "arrivalDTTM": "2022-03-25T10:30:00",
- "confirmedDTTM": "2022-03-25T10:30:00",
- "departureDTTM": "2022-03-25T10:30:00",
- "duration": 22,
- "etaCode": "string",
- "podDoc": [
- {
- "createdTime": "2022-03-25T10:30:00",
- "documentName": "Cumberland Mall Delivery",
- "documentPath": "/path/to/document.pdf",
- "documentGuid": "123e4567-e89b-12d3-a456-426614174000",
- "extension": "pdf"
}
]
}, - "exceptionPresent": true,
- "exceptions": [
- {
- "exceptionCode": "AH",
- "exceptionDesc": "After Hours",
- "exceptionComment": "DAMAGED PRODUCT/TOTE",
- "addedByName": "AH",
- "addedOn": "2022-03-25T10:30:00"
}
], - "cancellation": {
- "reasonCode": "ADR",
- "reasonDesc": "Invalid Address",
- "cancelDTTM": "2022-03-25T10:30:00",
- "cancelTimeZone": "GMT"
}
}
}, - "reasons": [
- {
- "description": "Company Code is required.",
- "reasonCode": 1505
}
]
}
List of Stop/Order which is usually the product name, quantity, capacity constraints etc.
companyCode required | string <= 50 characters Company Code which the shipment belongs to. |
shipmentNbr required | string <= 100 characters Alpha numeric value used to refer a shipment. |
zipCode required | string <= 20 characters zip code of ship to address of stop/order. |
fromDTTM required | string <= 22 characters Scheduled date and time in local format |
toDTTM required | string <= 22 characters Earliest Scheduled date and time in local format |
{- "stops": [
- {
- "Stop": {
- "stop": {
- "stopId": "abcd123340707",
- "stopNbr": "Stop039",
- "stopSeq": "1",
- "stopType": "DO",
- "shipmentType": "REG",
- "company": {
- "code": "DCCOMP1",
- "name": "DC COMPANY"
}, - "visibility": [
- {
- "header": "string",
- "values": [
- "string"
]
}
], - "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": null,
- "signatoryName": null,
- "optional": null
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "to": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": null,
- "signatoryName": null,
- "optional": null
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "facility": {
- "facilityId": "63426ffabc35656",
- "label": "East Region Office"
}, - "invoiceRef": {
- "reference1": "Invoice Reference 1",
- "reference2": "Invoice Reference 2",
- "reference3": "Invoice Reference 3",
- "reference4": "Invoice Reference 4"
}, - "shipForBP": "1163",
- "shipperCode": "S201",
- "profile": "Electronics",
- "templateId": "abcd123340707",
- "consAttribute": "DNCA26R1S1021820",
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "shipmentNbr": "ShipmentNbr003",
- "receiveStatus": 3,
- "doConfirmation": "01",
- "puConfirmation": "00",
- "hubId": "LM1",
- "trailerCode": "tc2",
- "vehicleTypes": [
- "BOX",
- "TRUCK"
], - "accountNumber": "ACC01",
- "billTo": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "bol": "MBOL39203",
- "freightTerms": "new DC",
- "proNumber": "TC123",
- "reference1": "TCS1001",
- "reference2": "TCS1002",
- "sealNbr": 1,
- "stopPriority": 1,
- "totalCartons": "10",
- "totalPallets": "8",
- "volume": "10",
- "volumeUOM": "CBM",
- "weight": "100",
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "markAsReceived": true,
- "createdDttm": "2001-12-31T12:00:00",
- "receivedDttm": "2001-12-31T12:00:00",
- "laneNumber": "L1",
- "deliveryAttempt": 1,
- "altStopSeq": "A10",
- "stopGeofenceRadius": 150,
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "totalPrice": "123.85",
- "sourceType": "INTG/USER",
- "stopAccessorials": [
- {
- "code": "ACC",
- "comments": "ACC report for Stop",
- "type": "DO",
- "calcUnits": 10,
- "matchUnits": 25
}
], - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": "1",
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "palletID": "235AZRFTG",
- "orderDate": "2019-12-10",
- "toteID": 132245565,
- "trailerCode": "tcl",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "deliveryType": "DO",
- "customerPO": "100PO",
- "custRouteNbr": 151,
- "custStopNbr": 135,
- "customerOrderNbr": 124234356,
- "invoiceNbr": 102345001,
- "invoiceDate": "2019-12-09",
- "pickingNumber": "904729",
- "accountNumber": "ACC01",
- "confirmationType": "P",
- "lineType": 1,
- "referenceText": "Fragile item",
- "originalLineNumber": "10",
- "serviceCategory": "UNITS@20151021-0047-PALLET_1-003",
- "volume": "10",
- "volumeUOM": "cubic meters",
- "weight": "100",
- "weightUOM": "kilograms",
- "unitPrice": 40.1,
- "productCategory": "DRY",
- "productSubCategory": "Boxes & Trays",
- "substituteItem": true,
- "commitmentItem": true,
- "redelivery": true,
- "earliestDTTM": "2019-03-25T10:30:00",
- "latestDTTM": "2019-03-25T10:33:00",
- "length": "123.85",
- "lengthUOM": "inch",
- "width": "123.85",
- "widthUOM": "inch",
- "height": "123.85",
- "heightUOM": "inch",
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "consAttribute": "DNCA26R1S1021820",
- "collectSerialNbr": "GS1",
- "originCode": "AF2EA",
- "originName": "GS1 ATLANTA",
- "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "cartonContents": [
- {
- "itemId": "string",
- "description": "string",
- "toteId": "TCS1002",
- "qty": 0,
- "quantityUOM": "Cartons",
- "weight": "100",
- "weightUOM": "Kg",
- "reference1": "TCS1001",
- "reference2": "string",
- "shipperOrderNumber": "string",
- "custOrderNumber": "string",
- "customerComments": "In-valid details"
}
], - "confirmed": {
- "confirmedQty": "28",
- "scannedQty": "28",
- "puConfirmedQty": "28",
- "puScannedQty": "28",
- "exceptionReasonCode": "DMG",
- "exceptionComments": "Packing was damaged",
- "rcvQty": "28",
- "rcvScndQty": "28"
}
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "privateNotes": [
- {
- "userName": null,
- "description": "Stop Deliver to Cumberland Mall",
- "addedBy": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "stopAssignment": {
- "carrierCode": "XYZBP",
- "carrierName": "XYZBP"
}, - "planningType": "MANUAL",
- "routeProfile": {
- "id": "65b76331e6d05c080d1d11a4",
- "name": "Route Profile A"
}, - "assignedBillAmt": "123.25",
- "apptInfo": {
- "apptId": "345253",
- "apptStatus": "SCHEDULED",
- "apptDate": "2023-09-21",
- "startTime": "09:30",
- "endTime": "15:00",
- "comment": "Delivery timigs are strict"
}, - "trackingInfo": {
- "trackingEnabled": true,
- "trackingURL": "URL"
}, - "srvcLevel": "inch",
- "callerInfo": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "dispatcherInfo": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "estimationInfo": {
- "charges": [
- {
- "legNbr": "PU-FAC1",
- "contractId": "abcdefabcdef23248234",
- "assignedBillAmt": 234.2,
- "rateConfigEstimates": [
- {
- "code": null,
- "guid": null,
- "rateAmt": null
}
]
}
]
}
}, - "load": {
- "loadNbr": "ROUTE02390",
- "loadId": "234544sadec0000000a23451",
- "loadStatus": "01",
- "routeName": "Route-101",
- "routeStartDTTM": "2020-04-21T12:00:00",
- "departedDTTM": "2020-04-21T12:00:00",
- "driverName": "John Smith",
- "driverId": 123,
- "driverPhoneNum": "string",
- "vehicleNbr": "vehicle1",
- "vehicleType": "Truck",
- "createdDttm": "2001-12-31T12:00:00"
}, - "stopExecutionInfo": {
- "stopStatus": "10",
- "receiveStatus": "st",
- "receiveDTTM": "2022-03-25T10:30:00",
- "from": {
- "plannedEtaDTTM": "2022-03-25T10:30:00",
- "etaDttm": "2022-03-25T10:30:00",
- "arrivalDTTM": "2022-03-25T10:30:00",
- "confirmedDTTM": "2022-03-25T10:30:00",
- "departureDTTM": "2022-03-25T10:30:00",
- "duration": 22,
- "etaCode": "string",
- "podDoc": [
- {
- "createdTime": "2022-03-25T10:30:00",
- "documentName": "Cumberland Mall Delivery",
- "documentPath": "/path/to/document.pdf",
- "documentGuid": "123e4567-e89b-12d3-a456-426614174000",
- "extension": "pdf"
}
]
}, - "to": {
- "plannedEtaDTTM": "2022-03-25T10:30:00",
- "etaDttm": "2022-03-25T10:30:00",
- "arrivalDTTM": "2022-03-25T10:30:00",
- "confirmedDTTM": "2022-03-25T10:30:00",
- "departureDTTM": "2022-03-25T10:30:00",
- "duration": 22,
- "etaCode": "string",
- "podDoc": [
- {
- "createdTime": "2022-03-25T10:30:00",
- "documentName": "Cumberland Mall Delivery",
- "documentPath": "/path/to/document.pdf",
- "documentGuid": "123e4567-e89b-12d3-a456-426614174000",
- "extension": "pdf"
}
]
}, - "exceptionPresent": true,
- "exceptions": [
- {
- "exceptionCode": "AH",
- "exceptionDesc": "After Hours",
- "exceptionComment": "DAMAGED PRODUCT/TOTE",
- "addedByName": "AH",
- "addedOn": "2022-03-25T10:30:00"
}
], - "cancellation": {
- "reasonCode": "ADR",
- "reasonDesc": "Invalid Address",
- "cancelDTTM": "2022-03-25T10:30:00",
- "cancelTimeZone": "GMT"
}
}
}
}
], - "reasons": [
- {
- "description": "Company Code is required.",
- "reasonCode": 1505
}
]
}
Return the pickup and delivery ETA Details of Stop/Order.
companyCode required | string <= 50 characters Company Code which the Stop/Order belongs to. |
stopNbr | string <= 100 characters Unique alpha numeric value used to refer a Stop/Order. |
stopId | string <= 50 characters Unique alpha numeric system generated id used to refer a Stop/Order. Note: In query parameters either stopId or stopNbr is mandatory. |
{- "pickupETA": [
- {
- "etaDTTM": "2023-07-24T07:19:00",
- "earliestEtaDTTM": "2023-07-24T07:49:00",
- "latestEtaDTTM": "2023-07-24T08:19:00",
- "etaWindow": 30
}
], - "deliveryETA": [
- {
- "etaDTTM": "2023-07-24T07:19:00",
- "earliestEtaDTTM": "2023-07-24T07:49:00",
- "latestEtaDTTM": "2023-07-24T08:19:00",
- "etaWindow": 30
}
]
}
Return the ETA Details of Stop/Order.
companyCode required | string <= 50 characters Company Code which the Stop/Order belongs to. |
stopNbr | string <= 100 characters Unique alpha numeric value used to refer a Stop/Order. |
stopId | string <= 50 characters Unique alpha numeric system generated id used to refer a Stop/Order. Note: In query parameters either stopId or stopNbr is mandatory. |
{- "etaDTTM": "2023-07-24T07:19:00",
- "earliestEtaDTTM": "2023-07-24T07:49:00",
- "latestEtaDTTM": "2023-07-24T08:19:00",
- "etaWindow": 30
}
Return the event information of Stop/Order.
companyCode required | string <= 50 characters Company Code which the Stop/Order belongs to. |
stopNbr | string <= 100 characters Unique alpha numeric value used to refer a Stop/Order. |
stopId | string <= 50 characters Unique alpha numeric system generated id used to refer a Stop/Order. Note: In query parameters either stopId or stopNbr is mandatory. |
{- "events": [
- {
- "eventCode": "7014",
- "eventName": "Document Capture",
- "eventDTTM": "2023-07-24T07:20:00",
- "latitude": 28.458417,
- "longitude": -81.405577,
- "documentKey": "document-key"
}, - {
- "eventCode": "7080",
- "eventName": "Pickup Stop Depart",
- "eventDTTM": "2023-07-24T07:25:00",
- "latitude": 28.458417,
- "longitude": -81.405577,
- "documentKey": "document-key"
}
]
}
Import a Stop/Order for a certain Company
serviceName required | string <= 100 characters serviceName refer to custom integration for the company, set to "default" if not using a custom integration |
companyCode required | string <= 50 characters Company Code of Stop |
importRequest
companyCode required | string <= 20 characters Company Code of Stop. |
required | Array of objects (Stops) <= 500 items |
{- "companyCode": "XYZ,",
- "stops": [
- {
- "stopNbr": "Stop039",
- "stopId": "abcd123340707",
- "trailerCode": "tc1",
- "stopSeq": 1,
- "stopType": "DO",
- "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "XXXX",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey",
- "to": {
- "address": {
- "name": "Test-Stop",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "mike123@test.com",
- "phone": "4049371973",
- "sms": "4049371973"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "XXXX",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}
}, - "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974,",
- "sms": "3489865974,"
}
}, - "billTo": {
- "name": "test",
- "addr1": "1001 NOrth Taylor Road",
- "addr2": null,
- "city": "Rome",
- "state": "IL",
- "zip": "60446",
- "country": "US",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "bol": "eManifestNumber",
- "puConfirmation": "SKIP",
- "doConfirmation": "SCAN-VER",
- "profile": "Electronics",
- "comments": {
- "commentType": 1,
- "commentDescription": "Stop Deliver to Cumberland Mall"
}, - "assignedBillAmt": 123.25,
- "receiveStatus": "03",
- "srvcLevel": "Express",
- "callerInfo": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "2763252323"
}, - "dispatcherInfo": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "2763252323"
}, - "apptInfo": {
- "apptId": "345253"
}, - "stopDetails": [
- {
- "product": "ca630-2-3",
- "productIdentifier": "zx_24",
- "productCategory": "DRY",
- "deliveryType": "DO",
- "quantity": 1,
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "markfor": {
- "address": {
- "name": "HARRINGTON SURG.SUP.",
- "addr1": "1503 SOUTH RUSSELL STREET",
- "addr2": "",
- "city": "MISSOULA",
- "state": "MT",
- "zip": "59801",
- "country": "US",
- "landmark": "Hub001",
- "latitude": null,
- "longitude": null
}, - "contact": {
- "contactName": "Test-Stop",
- "email": null,
- "phone": null,
- "sms": null
}
}, - "custRouteNbr": 151,
- "custStopNbr": 135,
- "customerPO": "100PO",
- "customerOrderNbr": 124234356,
- "orderDate": "2019-12-10T00:00:00.000Z",
- "invoiceNbr": 102345001,
- "invoiceDate": "2019-12-09T00:00:00.000Z",
- "accountNumber": "ACC01",
- "toteID": 132245565,
- "trailerCode": "tc1",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "palletID": "235AZRFTG",
- "earliestDTTM": "2020-01-22T10:25:00",
- "latestDTTM": "2020-01-22T10:30:00",
- "consAttribute": "DNCA26R1S1021820",
- "collectSerialNbr": "GS1",
- "originName": "AF2EA",
- "originCode": "NVZ ATLANTA",
- "comments": {
- "commentType": 5,
- "commentDescription": "Carton should be in cooler all time"
}
}, - {
- "productIdentifier": "cx_300",
- "productCategory": "DRY",
- "deliveryType": "DO",
- "quantity": 1,
- "quantityUOM": "Cartons",
- "stopDetailSeq": 2,
- "markfor": {
- "address": {
- "name": "HARRINGTON SURG.SUP.",
- "addr1": "1503 SOUTH RUSSELL STREET",
- "addr2": "",
- "city": "MISSOULA",
- "state": "MT",
- "zip": "59801",
- "country": "US",
- "landmark": null,
- "latitude": null,
- "longitude": null
}, - "contact": {
- "contactName": null,
- "email": null,
- "phone": null,
- "sms": null
}
}, - "custRouteNbr": 151,
- "custStopNbr": 135,
- "customerPO": "100PO",
- "customerOrderNbr": 124234356,
- "orderDate": "2019-12-10T00:00:00.000Z",
- "invoiceNbr": 102345001,
- "invoiceDate": "2019-12-09T00:00:00.000Z",
- "accountNumber": "ACC02",
- "toteID": 132245565,
- "trailerCode": "tc1",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "palletID": "235AZRFTG",
- "earliestDTTM": "2020-01-22T10:25:00",
- "latestDTTM": "2020-01-22T10:26:00",
- "consAttribute": "DNCA26R1S1021820",
- "collectSerialNbr": "GS1",
- "comments": {
- "commentType": 5,
- "commentDescription": "Carton should be in cooler all time"
}
}
], - "stopAssignment": {
- "carrierCode": "XYZBP"
}
}
]
}
{- "status": "Success"
}
Import a Stop/Order for a certain Company
companyCode required | string <= 50 characters Company Code of Stop |
importRequest
companyCode required | string <= 20 characters Company Code of Stop. |
required | object (Stop) |
{- "companyCode": "XYZ,",
- "stop": {
- "stopNbr": "Stop039",
- "stopId": "abcd123340707",
- "trailerCode": "tc1",
- "stopSeq": 1,
- "stopType": "DO",
- "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "XXXX",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey",
- "to": {
- "address": {
- "name": "Test-Stop",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "mike123@test.com",
- "phone": "4049371973",
- "sms": "4049371973"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "XXXX",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}
}, - "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974,",
- "sms": "3489865974,"
}
}, - "billTo": {
- "name": "test",
- "addr1": "1001 NOrth Taylor Road",
- "addr2": null,
- "city": "Rome",
- "state": "IL",
- "zip": "60446",
- "country": "US",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "bol": "eManifestNumber",
- "puConfirmation": "SKIP",
- "doConfirmation": "SCAN-VER",
- "profile": "Electronics",
- "comments": {
- "commentType": 1,
- "commentDescription": "Stop Deliver to Cumberland Mall"
}, - "stopDetails": [
- {
- "product": "ca629-2-3",
- "productIdentifier": "zx_24",
- "productCategory": "DRY",
- "deliveryType": "DO",
- "quantity": 1,
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "markfor": {
- "address": {
- "name": "HARRINGTON SURG.SUP.",
- "addr1": "1503 SOUTH RUSSELL STREET",
- "addr2": "",
- "city": "MISSOULA",
- "state": "MT",
- "zip": "59801",
- "country": "US",
- "landmark": "Hub001",
- "latitude": null,
- "longitude": null
}, - "contact": {
- "contactName": "Test-Stop",
- "email": null,
- "phone": null,
- "sms": null
}
}, - "custRouteNbr": 151,
- "custStopNbr": 135,
- "customerPO": "100PO",
- "customerOrderNbr": 124234356,
- "orderDate": "2019-12-10T00:00:00.000Z",
- "invoiceNbr": 102345001,
- "invoiceDate": "2019-12-09T00:00:00.000Z",
- "accountNumber": "ACC01",
- "toteID": 132245565,
- "trailerCode": "tc1",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "palletID": "235AZRFTG",
- "earliestDTTM": "2020-01-22T10:25:00",
- "latestDTTM": "2020-01-22T10:30:00",
- "consAttribute": "DNCA26R1S1021820",
- "collectSerialNbr": "GS1",
- "comments": {
- "commentType": 5,
- "commentDescription": "Carton should be in cooler all time"
}
}, - {
- "productIdentifier": "cx_300",
- "productCategory": "DRY",
- "deliveryType": "DO",
- "quantity": 1,
- "quantityUOM": "Cartons",
- "stopDetailSeq": 2,
- "markfor": {
- "address": {
- "name": "HARRINGTON SURG.SUP.",
- "addr1": "1503 SOUTH RUSSELL STREET",
- "addr2": "",
- "city": "MISSOULA",
- "state": "MT",
- "zip": "59801",
- "country": "US",
- "landmark": null,
- "latitude": null,
- "longitude": null
}, - "contact": {
- "contactName": null,
- "email": null,
- "phone": null,
- "sms": null
}
}, - "custRouteNbr": 151,
- "custStopNbr": 135,
- "customerPO": "100PO",
- "customerOrderNbr": 124234356,
- "orderDate": "2019-12-10T00:00:00.000Z",
- "invoiceNbr": 102345001,
- "invoiceDate": "2019-12-09T00:00:00.000Z",
- "accountNumber": "ACC02",
- "toteID": 132245565,
- "trailerCode": "tc1",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "palletID": "235AZRFTG",
- "earliestDTTM": "2020-01-22T10:25:00",
- "latestDTTM": "2020-01-22T10:26:00",
- "consAttribute": "DNCA26R1S1021820",
- "collectSerialNbr": "GS1",
- "comments": {
- "commentType": 5,
- "commentDescription": "Carton should be in cooler all time"
}
}
], - "stopAssignment": {
- "carrierCode": "XYZBP"
}, - "apptInfo": {
- "apptId": "2343"
}
}
}
{- "status": "Success",
- "apiResult": {
- "created": 10,
- "updated": 10,
- "failed": 10,
- "deleted": 10,
- "errors": [
- {
- "key": "StopNbr123",
- "msgs": [
- "string"
]
}
]
}, - "reasons": [
- {
- "description": "Company Code is required.",
- "errorCode": 1505,
- "errorLiteral": "nuvizz_entity_error_xxyy"
}
]
}
Assign a Stop to a Business Partner/Carrier using Carrier Code
companyCode required | string <= 50 characters Company Code of Stop |
stopNbr required | string <= 100 characters Unique alpha numeric value that refers to a Stop/Order |
importRequest
carrierCode required | string <= 10 characters Load assigned carrier code. |
assignmentCriteria | string <= 10 characters It has a value 01 and when given so will look for the corresponding carrier code and assign the Load to available driver of that carrier. |
{- "carrierCode": "XYZBP",
- "assignmentCriteria": "01"
}
{- "status": "Success"
}
Assign a Stop to a Business Partner/Carrier using Carrier Code
companyCode required | string <= 50 characters Company Code of Stop |
importRequest
stopNbr | string <= 100 characters Unique alpha numeric value used to refer a Stop/Order. |
stopId | string <= 50 characters Unique alpha numeric system generated id used to refer a Stop/Order Note: In query parameters either stopNbr or stopId is mandatory. |
bpId | integer [ 0 .. 999999 ] Business Partner Id to which the stop has to be assigned. |
carrierCode | string <= 10 characters Carrier code to which the stop has to be assigned. Note: In query parameters either bpId or carrierCode is mandatory. |
assignmentCriteria | string <= 10 characters It has a value 01 and when given so will look for the corresponding carrier code and assign the Load to available driver of that carrier. |
{- "stopNbr": "S10001112",
- "stopId": "string",
- "bpId": 12345,
- "carrierCode": "XYZBP",
- "assignmentCriteria": "01"
}
{- "status": "Success"
}
Unassign a Stop from a Carrier/Business Partner(Previously assigned to a Carrier)
companyCode required | string <= 50 characters Company Code of Stop |
importRequest
stopNbr | string <= 100 characters Unique alpha numeric value used to refer a Stop/Order. |
stopId | string <= 50 characters Unique alpha numeric system generated id used to refer a Stop/Order Note: In query parameters either stopNbr or stopId is mandatory. |
{- "stopNbr": "S10001112",
- "stopId": "string"
}
{- "status": "Success"
}
Delete/Reject a stop(in unplanned, created statuses)
companyCode required | string <= 50 characters Company Code of Stop |
stopNbr | string <= 20 characters Unique alpha numeric value that refers to a Stop. |
stopId | string <= 50 characters Unique alpha numeric system generated id used to refer a Stop/Order Note: In query parameters either stopNbr or stopId is mandatory. |
reasonCode required | string <= 10 characters Code that refers to the particular system code for canceling a Stop. |
reasonComments | string <= 500 characters Comments entered during the cancellation of a stop/order. |
{- "stopNbr": "S10001112",
- "stopId": "S10001112",
- "reasonCode": "01",
- "reasonComments": "In-valid Stop details"
}
{- "status": "Success"
}
Import a advanced shipment notice (ASN)
serviceName required | string <= 50 characters serviceName refer to custom integration for the company, set to "default" if not using a custom integration |
companyCode required | string <= 50 characters Company Code of Stop |
importRequest
companyCode required | string <= 20 characters Company Code of Stop. |
required | Array of objects (Stops) <= 500 items |
{- "companyCode": "XYZ",
- "stops": [
- {
- "stopId": "abcd123340707",
- "stopNbr": "Stop039",
- "stopSeq": "1",
- "stopType": "DO",
- "shipmentType": "REG",
- "company": {
- "code": "DCCOMP1",
- "name": "DC COMPANY"
}, - "visibility": [
- {
- "header": "string",
- "values": [
- "string"
]
}
], - "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "to": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "facility": {
- "facilityId": "63426ffabc35656",
- "label": "East Region Office"
}, - "invoiceRef": {
- "reference1": "Invoice Reference 1",
- "reference2": "Invoice Reference 2",
- "reference3": "Invoice Reference 3",
- "reference4": "Invoice Reference 4"
}, - "shipForBP": "1163",
- "shipperCode": "S201",
- "profile": "Electronics",
- "templateId": "abcd123340707",
- "consAttribute": "DNCA26R1S1021820",
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "shipmentNbr": "ShipmentNbr003",
- "receiveStatus": 3,
- "doConfirmation": "01",
- "puConfirmation": "00",
- "hubId": "LM1",
- "trailerCode": "tc2",
- "vehicleTypes": [
- "BOX",
- "TRUCK"
], - "accountNumber": "ACC01",
- "billTo": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "bol": "MBOL39203",
- "freightTerms": "new DC",
- "proNumber": "TC123",
- "reference1": "TCS1001",
- "reference2": "TCS1002",
- "sealNbr": 1,
- "stopPriority": 1,
- "totalCartons": "10",
- "totalPallets": "8",
- "volume": "10",
- "volumeUOM": "CBM",
- "weight": "100",
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "markAsReceived": true,
- "createdDttm": "2001-12-31T12:00:00",
- "receivedDttm": "2001-12-31T12:00:00",
- "laneNumber": "L1",
- "deliveryAttempt": 1,
- "altStopSeq": "A10",
- "stopGeofenceRadius": 150,
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "totalPrice": "123.85",
- "sourceType": "INTG/USER",
- "stopAccessorials": [
- {
- "code": "ACC",
- "comments": "ACC report for Stop",
- "type": "DO",
- "calcUnits": 10,
- "matchUnits": 25
}
], - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": "1",
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "palletID": "235AZRFTG",
- "orderDate": "2019-12-10",
- "toteID": 132245565,
- "trailerCode": "tcl",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "deliveryType": "DO",
- "customerPO": "100PO",
- "custRouteNbr": 151,
- "custStopNbr": 135,
- "customerOrderNbr": 124234356,
- "invoiceNbr": 102345001,
- "invoiceDate": "2019-12-09",
- "pickingNumber": "904729",
- "accountNumber": "ACC01",
- "confirmationType": "P",
- "lineType": 1,
- "referenceText": "Fragile item",
- "originalLineNumber": "10",
- "serviceCategory": "UNITS@20151021-0047-PALLET_1-003",
- "volume": "10",
- "volumeUOM": "cubic meters",
- "weight": "100",
- "weightUOM": "kilograms",
- "unitPrice": 40.1,
- "productCategory": "DRY",
- "productSubCategory": "Boxes & Trays",
- "substituteItem": true,
- "commitmentItem": true,
- "redelivery": true,
- "earliestDTTM": "2019-03-25T10:30:00",
- "latestDTTM": "2019-03-25T10:33:00",
- "length": "123.85",
- "lengthUOM": "inch",
- "width": "123.85",
- "widthUOM": "inch",
- "height": "123.85",
- "heightUOM": "inch",
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "consAttribute": "DNCA26R1S1021820",
- "collectSerialNbr": "GS1",
- "originCode": "AF2EA",
- "originName": "GS1 ATLANTA",
- "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "cartonContents": [
- {
- "itemId": "string",
- "description": "string",
- "toteId": "TCS1002",
- "qty": 0,
- "quantityUOM": "Cartons",
- "weight": "100",
- "weightUOM": "Kg",
- "reference1": "TCS1001",
- "reference2": "string",
- "shipperOrderNumber": "string",
- "custOrderNumber": "string",
- "customerComments": "In-valid details"
}
], - "confirmed": {
- "confirmedQty": "28",
- "scannedQty": "28",
- "puConfirmedQty": "28",
- "puScannedQty": "28",
- "exceptionReasonCode": "DMG",
- "exceptionComments": "Packing was damaged",
- "rcvQty": "28",
- "rcvScndQty": "28"
}
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "privateNotes": [
- {
- "userName": null,
- "description": "Stop Deliver to Cumberland Mall",
- "addedBy": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "stopAssignment": {
- "carrierCode": "XYZBP",
- "carrierName": "XYZBP"
}, - "planningType": "MANUAL",
- "routeProfile": {
- "id": "65b76331e6d05c080d1d11a4",
- "name": "Route Profile A"
}, - "assignedBillAmt": "123.25",
- "apptInfo": {
- "apptId": "345253",
- "apptStatus": "SCHEDULED",
- "apptDate": "2023-09-21",
- "startTime": "09:30",
- "endTime": "15:00",
- "comment": "Delivery timigs are strict"
}, - "trackingInfo": {
- "trackingEnabled": true,
- "trackingURL": "URL"
}, - "srvcLevel": "inch",
- "callerInfo": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "dispatcherInfo": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "estimationInfo": {
- "charges": [
- {
- "legNbr": "PU-FAC1",
- "contractId": "abcdefabcdef23248234",
- "assignedBillAmt": 234.2,
- "rateConfigEstimates": [
- {
- "code": "RT_v1",
- "guid": "abcdcdfgh",
- "rateAmt": 234.2
}
]
}
]
}
}
]
}
{- "status": "Success"
}
Delete/Reject a ASN(InboundShipment status)
companyCode required | string <= 50 characters Company Code of Stop |
stopNbr | string <= 20 characters Unique alpha numeric value that refers to a Stop. |
stopId | string <= 50 characters Unique alpha numeric system generated id used to refer a Stop/Order Note: In query parameters either stopNbr or stopId is mandatory. |
reasonCode required | string <= 10 characters Code that refers to the particular system code for canceling a Stop. |
reasonComments | string <= 500 characters Comments entered during the cancellation of a stop/order. |
{- "stopNbr": "S10001112",
- "stopId": "S10001112",
- "reasonCode": "01",
- "reasonComments": "In-valid Stop details"
}
{- "status": "Success"
}
Lists the stop templates belonging to the company code. If name is provided, template of that name belonging to the company code will be listed.
companyCode required | string <= 50 characters Company Code of StopTemplate |
name | string <= 100 characters Unique name for this StopTemplate. If Id is provided, id takes precedence Either id or name must be provided. |
id | string <= 50 characters Unique internal Id of StopTemplate. ID takes precedence over name |
type | string <= 20 characters Template type can be either TEMP_STOP or ORD_PROF. |
{- "stopTemplates": [
- {
- "id": "string",
- "name": "string",
- "recurs": {
- "prefix": "Stop",
- "startDate": "2023-07-12",
- "endDate": "2023-07-12",
- "daysOfWeek": "MT"
}, - "stopTemplate": {
- "stopType": "DO",
- "shipmentType": "REG",
- "stopStatus": 20,
- "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "to": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "profile": "Electronics",
- "facility": {
- "facilityId": "63426ffabc35656",
- "label": "East Region Office"
}, - "vehicleType": {
- "id": "28",
- "name": "VEH-1"
}, - "shipForBP": "1163",
- "shipperCode": "S201",
- "consAttribute": "DNCA26R1S1021820",
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "shipmentNbr": "ShipmentNbr003",
- "doConfirmation": "01",
- "puConfirmation": "00",
- "hubId": "LM1",
- "trailerCode": "tc2",
- "accountNumber": "ACC01",
- "billTo": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "bol": "MBOL39203",
- "freightTerms": "new DC",
- "proNumber": "TC123",
- "reference1": "TCS1001",
- "reference2": "TCS1002",
- "sealNbr": 1,
- "stopPriority": 1,
- "totalCartons": "10",
- "totalPallets": "8",
- "volume": "10",
- "volumeUOM": "CBM",
- "weight": "100",
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "laneNumber": "L1",
- "altStopSeq": "A10",
- "stopGeofenceRadius": 150,
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "totalPrice": "123.85",
- "stopDistance": "123.0",
- "sourceType": "INTG/USER",
- "stopAccessorials": [
- {
- "code": "ACC",
- "comments": "ACC report for Stop",
- "type": "DO",
- "calcUnits": 10,
- "matchUnits": 25
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "stopAssignment": {
- "carrierCode": "XYZBP",
- "carrierName": "XYZBP"
}, - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": "1",
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "palletID": "235AZRFTG",
- "orderDate": "2019-12-10",
- "toteID": 132245565,
- "trailerCode": "tcl",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "deliveryType": "DO",
- "customerPO": "100PO",
- "custRouteNbr": 151,
- "custStopNbr": 135,
- "customerOrderNbr": 124234356,
- "invoiceNbr": 102345001,
- "invoiceDate": "2019-12-09",
- "pickingNumber": "904729",
- "accountNumber": "ACC01",
- "confirmationType": "P",
- "lineType": 1,
- "referenceText": "Fragile item",
- "originalLineNumber": "10",
- "serviceCategory": "UNITS@20151021-0047-PALLET_1-003",
- "volume": "10",
- "volumeUOM": "cubic meters",
- "weight": "100",
- "weightUOM": "kilograms",
- "unitPrice": 40.1,
- "productCategory": "DRY",
- "productSubCategory": "Boxes & Trays",
- "substituteItem": true,
- "commitmentItem": true,
- "redelivery": true,
- "earliestDTTM": "2019-03-25T10:30:00",
- "latestDTTM": "2019-03-25T10:33:00",
- "length": "123.85",
- "lengthUOM": "inch",
- "width": "123.85",
- "widthUOM": "inch",
- "height": "123.85",
- "heightUOM": "inch",
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "consAttribute": "DNCA26R1S1021820",
- "collectSerialNbr": "GS1",
- "originCode": "AF2EA",
- "originName": "GS1 ATLANTA",
- "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "cartonContents": [
- {
- "itemId": "string",
- "description": "string",
- "toteId": "TCS1002",
- "qty": 0,
- "quantityUOM": "Cartons",
- "weight": "100",
- "weightUOM": "Kg",
- "reference1": "TCS1001",
- "reference2": "string",
- "shipperOrderNumber": "string",
- "custOrderNumber": "string",
- "customerComments": "In-valid details"
}
], - "confirmed": {
- "confirmedQty": "28",
- "scannedQty": "28",
- "puConfirmedQty": "28",
- "puScannedQty": "28",
- "exceptionReasonCode": "DMG",
- "exceptionComments": "Packing was damaged",
- "rcvQty": "28",
- "rcvScndQty": "28"
}
}
]
}
}
]
}
Lists the stop templates belonging to the company code. If name is provided, template of that name belonging to the company code will be listed.
companyCode required | string <= 50 characters Company Code of StopTemplate |
pageSize required | number [ 0 .. 99999 ] Page size determined by the application. |
page required | number [ 0 .. 99999 ] The current page number being queried. |
maxResult required | number [ 0 .. 99999 ] Maximum number of records per page. |
{- "pageSize": 20,
- "page": 1,
- "maxResult": 20
}
{- "totalRecords": 81,
- "defaultSize": 20,
- "currentPageSize": 1,
- "pageNo": 5,
- "stopTemplates": [
- {
- "id": "string",
- "name": "string",
- "recurs": {
- "prefix": "Stop",
- "startDate": "2023-07-12",
- "endDate": "2023-07-12",
- "daysOfWeek": "MT"
}, - "stopTemplate": {
- "stopType": "DO",
- "shipmentType": "REG",
- "stopStatus": 20,
- "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "to": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "profile": "Electronics",
- "facility": {
- "facilityId": "63426ffabc35656",
- "label": "East Region Office"
}, - "vehicleType": {
- "id": "28",
- "name": "VEH-1"
}, - "shipForBP": "1163",
- "shipperCode": "S201",
- "consAttribute": "DNCA26R1S1021820",
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "shipmentNbr": "ShipmentNbr003",
- "doConfirmation": "01",
- "puConfirmation": "00",
- "hubId": "LM1",
- "trailerCode": "tc2",
- "accountNumber": "ACC01",
- "billTo": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "bol": "MBOL39203",
- "freightTerms": "new DC",
- "proNumber": "TC123",
- "reference1": "TCS1001",
- "reference2": "TCS1002",
- "sealNbr": 1,
- "stopPriority": 1,
- "totalCartons": "10",
- "totalPallets": "8",
- "volume": "10",
- "volumeUOM": "CBM",
- "weight": "100",
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "laneNumber": "L1",
- "altStopSeq": "A10",
- "stopGeofenceRadius": 150,
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "totalPrice": "123.85",
- "stopDistance": "123.0",
- "sourceType": "INTG/USER",
- "stopAccessorials": [
- {
- "code": "ACC",
- "comments": "ACC report for Stop",
- "type": "DO",
- "calcUnits": 10,
- "matchUnits": 25
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "stopAssignment": {
- "carrierCode": "XYZBP",
- "carrierName": "XYZBP"
}, - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": "1",
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "palletID": "235AZRFTG",
- "orderDate": "2019-12-10",
- "toteID": 132245565,
- "trailerCode": "tcl",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "deliveryType": "DO",
- "customerPO": "100PO",
- "custRouteNbr": 151,
- "custStopNbr": 135,
- "customerOrderNbr": 124234356,
- "invoiceNbr": 102345001,
- "invoiceDate": "2019-12-09",
- "pickingNumber": "904729",
- "accountNumber": "ACC01",
- "confirmationType": "P",
- "lineType": 1,
- "referenceText": "Fragile item",
- "originalLineNumber": "10",
- "serviceCategory": "UNITS@20151021-0047-PALLET_1-003",
- "volume": "10",
- "volumeUOM": "cubic meters",
- "weight": "100",
- "weightUOM": "kilograms",
- "unitPrice": 40.1,
- "productCategory": "DRY",
- "productSubCategory": "Boxes & Trays",
- "substituteItem": true,
- "commitmentItem": true,
- "redelivery": true,
- "earliestDTTM": "2019-03-25T10:30:00",
- "latestDTTM": "2019-03-25T10:33:00",
- "length": "123.85",
- "lengthUOM": "inch",
- "width": "123.85",
- "widthUOM": "inch",
- "height": "123.85",
- "heightUOM": "inch",
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "consAttribute": "DNCA26R1S1021820",
- "collectSerialNbr": "GS1",
- "originCode": "AF2EA",
- "originName": "GS1 ATLANTA",
- "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "cartonContents": [
- {
- "itemId": "string",
- "description": "string",
- "toteId": "TCS1002",
- "qty": 0,
- "quantityUOM": "Cartons",
- "weight": "100",
- "weightUOM": "Kg",
- "reference1": "TCS1001",
- "reference2": "string",
- "shipperOrderNumber": "string",
- "custOrderNumber": "string",
- "customerComments": "In-valid details"
}
], - "confirmed": {
- "confirmedQty": "28",
- "scannedQty": "28",
- "puConfirmedQty": "28",
- "puScannedQty": "28",
- "exceptionReasonCode": "DMG",
- "exceptionComments": "Packing was damaged",
- "rcvQty": "28",
- "rcvScndQty": "28"
}
}
]
}
}
]
}
Import a Stop Template for a certain Company
companyCode required | string <= 50 characters Company Code of Stop Template |
importRequest
id | string <= 50 characters Internal ID of StopTemplate Used for Delete or updates. For create requests, do not send this element |
companyCode required | string <= 50 characters Company code of the template |
name required | string <= 100 characters Name of the template |
object (RecurringSchedule) Recurring Schedule information | |
required | object (StopTemplate) Stop Template |
{- "id": "abcdefabcdef0002020",
- "companyCode": "ABC",
- "name": "templateName",
- "recurs": {
- "prefix": "Stop",
- "startDate": "2023-07-12",
- "endDate": "2023-07-12",
- "daysOfWeek": "MT"
}, - "stopTemplate": {
- "stopType": "DO",
- "shipmentType": "REG",
- "stopStatus": 20,
- "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "to": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "profile": "Electronics",
- "facility": {
- "facilityId": "63426ffabc35656",
- "label": "East Region Office"
}, - "vehicleType": {
- "id": "28",
- "name": "VEH-1"
}, - "shipForBP": "1163",
- "shipperCode": "S201",
- "consAttribute": "DNCA26R1S1021820",
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "shipmentNbr": "ShipmentNbr003",
- "doConfirmation": "01",
- "puConfirmation": "00",
- "hubId": "LM1",
- "trailerCode": "tc2",
- "accountNumber": "ACC01",
- "billTo": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "bol": "MBOL39203",
- "freightTerms": "new DC",
- "proNumber": "TC123",
- "reference1": "TCS1001",
- "reference2": "TCS1002",
- "sealNbr": 1,
- "stopPriority": 1,
- "totalCartons": "10",
- "totalPallets": "8",
- "volume": "10",
- "volumeUOM": "CBM",
- "weight": "100",
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "laneNumber": "L1",
- "altStopSeq": "A10",
- "stopGeofenceRadius": 150,
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "totalPrice": "123.85",
- "stopDistance": "123.0",
- "sourceType": "INTG/USER",
- "stopAccessorials": [
- {
- "code": "ACC",
- "comments": "ACC report for Stop",
- "type": "DO",
- "calcUnits": 10,
- "matchUnits": 25
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "stopAssignment": {
- "carrierCode": "XYZBP",
- "carrierName": "XYZBP"
}, - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": "1",
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "markfor": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "palletID": "235AZRFTG",
- "orderDate": "2019-12-10",
- "toteID": 132245565,
- "trailerCode": "tcl",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "deliveryType": "DO",
- "customerPO": "100PO",
- "custRouteNbr": 151,
- "custStopNbr": 135,
- "customerOrderNbr": 124234356,
- "invoiceNbr": 102345001,
- "invoiceDate": "2019-12-09",
- "pickingNumber": "904729",
- "accountNumber": "ACC01",
- "confirmationType": "P",
- "lineType": 1,
- "referenceText": "Fragile item",
- "originalLineNumber": "10",
- "serviceCategory": "UNITS@20151021-0047-PALLET_1-003",
- "volume": "10",
- "volumeUOM": "cubic meters",
- "weight": "100",
- "weightUOM": "kilograms",
- "unitPrice": 40.1,
- "productCategory": "DRY",
- "productSubCategory": "Boxes & Trays",
- "substituteItem": true,
- "commitmentItem": true,
- "redelivery": true,
- "earliestDTTM": "2019-03-25T10:30:00",
- "latestDTTM": "2019-03-25T10:33:00",
- "length": "123.85",
- "lengthUOM": "inch",
- "width": "123.85",
- "widthUOM": "inch",
- "height": "123.85",
- "heightUOM": "inch",
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "consAttribute": "DNCA26R1S1021820",
- "collectSerialNbr": "GS1",
- "originCode": "AF2EA",
- "originName": "GS1 ATLANTA",
- "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "cartonContents": [
- {
- "itemId": "string",
- "description": "string",
- "toteId": "TCS1002",
- "qty": 0,
- "quantityUOM": "Cartons",
- "weight": "100",
- "weightUOM": "Kg",
- "reference1": "TCS1001",
- "reference2": "string",
- "shipperOrderNumber": "string",
- "custOrderNumber": "string",
- "customerComments": "In-valid details"
}
], - "confirmed": {
- "confirmedQty": "28",
- "scannedQty": "28",
- "puConfirmedQty": "28",
- "puScannedQty": "28",
- "exceptionReasonCode": "DMG",
- "exceptionComments": "Packing was damaged",
- "rcvQty": "28",
- "rcvScndQty": "28"
}
}
]
}
}
{- "status": "Success"
}
Cancel a stopTemplate
companyCode required | string <= 50 characters Company Code of StopTemplate |
name | string <= 100 characters Unique name for this StopTemplate. If Id is provided, id takes precedence Either id or name must be provided. |
id | string <= 50 characters Unique internal Id of StopTemplate. ID takes precedence over name |
{- "status": "Success"
}
Create or Update business partner
companyCode required | string <= 50 characters Company Code for which Business Partner is created |
companyCode required | string <= 20 characters CompanyCode to which the Business parter belongs |
required | Array of objects (BusinessPartners) <= 20 items |
{- "companyCode": "XYZ",
- "businessPartners": [
- {
- "partnerCode": "XYZBP1",
- "partnerName": "ABC Transport",
- "partnerType": "Carrier",
- "contactName": "Jon",
- "contactEmail": "Jon@abc.com",
- "tags": "XDOCK"
}
]
}
{- "status": "Success"
}
Associate Customers to Business Partner
companyCode required | string <= 50 characters Company Code for which Business Partner is created |
bpId | string <= 10 characters Unique Id generated in nuDeliverit system to refer specific BusinessPartner. |
bpCode | string <= 10 characters Business Partner Code. Note: In query parameters either bpId or bpCode is mandatory. |
accountNumbers required | Array of strings <= 500 items [ items <= 20 characters ] List of Customer Account Numbers. |
{- "accountNumbers": [
- "ACCOUNT-1",
- "ACCOUNT-2"
]
}
{- "reasons": [
- {
- "description": "Company Code is required.",
- "reasonCode": 1505
}
]
}
Business Partner Customer information
companyCode required | string <= 50 characters Company Code for which Business Partner is created |
bpId | string <= 10 characters Unique Id generated in nuDeliverit system to refer specific BusinessPartner. |
bpCode | string <= 10 characters Business Partner Code. Note: In query parameters either bpId or bpCode is mandatory. |
{- "bpId": "string",
- "customers": [
- {
- "accountNumber": "ACC01",
- "name": "customer1",
- "customerRef": "abcdd123"
}
]
}
The User API, partners will be able to create users on the system.
User Roles | Comments |
---|---|
MemberAdmin | This is a super admin user for a company and this user can Create new users Access to all admin functions within the system. User rights include Create/enable/disable new/existing users. Able to create/edit/update new filters, reports, and dashboards. No access to driver app |
DI_Receiver | With this role, the user will be able to login to the nuStockIt app and perform the action like Receive cartons Load returns |
DI_Integration | This is the Integration user role and can, Upload and interface load data into the system. Restricted/limited access to portal screens. No access to driver app. Cannot create/update new/existing users on platform |
DI_Inquiry | This is a view-only user role and the user can only have view-only access to specific portal screens,No access to driver app. For eg., the user will be able to access the various screens but will be prohibited from making any updates/changes on any of the portal screens |
DI_Driver | With this role, the user will be able to login to the driver app and perform the actions like, execute assigned loads/routes on the driver app (POD capture etc). No access to the portal. No edits/updates can be done to the loads assigned for execution on the app with this role |
DI_Dispatcher | The user can Login to the portal with the credentials provided. User access include create/enable/disable new/existing users. Perform all dispatcher functions required on the portal like create/edit/update loads/stops, assign /unassign drivers and carriers Restrictions included when creating/editing filters, reports, and dashboards. No access to driver app |
companyCode required | string <= 50 characters CompanyCode to which the user belongs |
companyCode required | string <= 20 characters CompanyCode to which the User belongs |
required | Array of objects (Users) <= 500 items |
{- "companyCode": "001Test",
- "users": [
- {
- "id": "abcdef123456",
- "userId": 12345,
- "allowedFacilities": [
- "FAC-1",
- "FAC-2"
], - "defaultFacility": "FAC-1",
- "allowAllFacilites": false,
- "defaultCompany": "COMPCODE-1",
- "allowedCompanies": [
- "COMPCODE-1",
- "COMPCODE-2"
], - "allowAllCompanies": false,
- "firstName": "Test",
- "lastName": "Bond",
- "middleName": "Neo",
- "userName": "TestUser",
- "password": "********",
- "gender": "M",
- "dob": "2001-12-31T12:00:00",
- "age": 29,
- "email": "dr1231@nuvizz.com",
- "cdlNumber": 5112747890,
- "mobileNumber": 4048621577,
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": 30339,
- "country": "USA",
- "landmark": "Hub001"
}, - "accountStatus": "ENABLED",
- "vendorId": "abcdef123456",
- "vehicle": {
- "type": "Ambulance",
- "description": "vehicle used as ambulance",
- "vin": "VEHL1234",
- "numberPlate": "804623F",
- "gvwr": 6600,
- "capacity": 100,
- "tireSize": 22.5,
- "maxCubicFeet": 270,
- "boxLWH": "10*10*10",
- "insuranceDate": "2020-12-31T00:00:00.000Z",
- "vehiclePicPath": "vehicle/vehiclepic/document/COMPCODE/43221",
- "registrationExpiryDate": "2030-12-31T00:00:00.000Z",
- "insuranceExpiryDate": "2030-12-31T00:00:00.000Z",
- "insuranceCompanyName": "BAJAJ",
- "insurancePolicyNbr": "INS2345",
- "insuranceLimit": 2
}, - "passwordNeverExpires": false,
- "forcePwdChg": false,
- "accountLocked": false,
- "accountNumber": "56A31D",
- "profilePicPath": "/document/profile/12345",
- "documents": [
- "/document/userdocs/12345",
- "/document/userdocs/12346"
], - "groupNames": [
- "MEMBERADMIN",
- "DRIVER"
], - "assignmentType": 1,
- "enabled": true,
- "unableToUseApp": true,
- "licenseAuthority": "DMV",
- "licenseExpirationDttm": "2001-12-31T12:00:00",
- "licenseState": "Georgia",
- "phoneNumber": "4048621577",
- "smsNumber": "4048621577",
- "userKey": "Client assign key",
- "profilePic": "Base64 png image",
- "ref1": "reference1",
- "ref2": "reference2",
- "ref3": "reference3",
- "userRoles": [
- {
- "role": "MemberAdmin"
}, - {
- "role": "DI_Dispatcher"
}, - {
- "role": "DI_Driver"
}, - {
- "role": "DI_Inquiry"
}, - {
- "role": "DI_Integration"
}, - {
- "role": "DI_Receiver"
}
], - "settlementRequired": "YES",
- "title": "DRIVER",
- "driverPermission": "YES",
- "salesPermission": "NO",
- "startDate": "2024-12-01",
- "endDate": "2024-12-02",
- "driverNo": 2456,
- "contractExpDate": "2024-12-30",
- "medCardExpDate": "2024-12-30"
}
]
}
{- "status": "Success",
- "apiResult": {
- "created": 10,
- "updated": 10,
- "failed": 10,
- "deleted": 10,
- "errors": [
- {
- "key": "StopNbr123",
- "msgs": [
- "string"
]
}
]
}, - "reasons": [
- {
- "description": "Company Code is required.",
- "errorCode": 1505,
- "errorLiteral": "nuvizz_entity_error_xxyy"
}
]
}
With the User API, partners will be able to create, modify and disable users on the system.
User Roles | Comments |
---|---|
MemberAdmin | This is a super admin user for a company and this user can Create new users Access to all admin functions within the system. User rights include Create/enable/disable new/existing users. Able to create/edit/update new filters, reports, and dashboards. No access to driver app |
DI_Receiver | With this role, the user will be able to login to the nuStockIt app and perform the action like Receive cartons Load returns |
DI_Integration | This is the Integration user role and can, Upload and interface load data into the system. Restricted/limited access to portal screens. No access to driver app. Cannot create/update new/existing users on platform |
DI_Inquiry | This is a view-only user role and the user can only have view-only access to specific portal screens,No access to driver app. For eg., the user will be able to access the various screens but will be prohibited from making any updates/changes on any of the portal screens |
DI_Driver | With this role, the user will be able to login to the driver app and perform the actions like, execute assigned loads/routes on the driver app (POD capture etc). No access to the portal. No edits/updates can be done to the loads assigned for execution on the app with this role |
DI_Dispatcher | The user can Login to the portal with the credentials provided. User access include create/enable/disable new/existing users. Perform all dispatcher functions required on the portal like create/edit/update loads/stops, assign /unassign drivers and carriers Restrictions included when creating/editing filters, reports, and dashboards. No access to driver app |
companyCode required | string <= 50 characters CompanyCode to which the user belongs |
companyCode required | string <= 20 characters CompanyCode to which the User belongs |
required | Array of objects (Users) <= 500 items |
{- "companyCode": "001Test",
- "users": [
- {
- "id": "abcdef123456",
- "userId": 12345,
- "allowedFacilities": [
- "FAC-1",
- "FAC-2"
], - "defaultFacility": "FAC-1",
- "allowAllFacilites": false,
- "allowedCompanies": [
- "COMPCODE-1",
- "COMPCODE-2"
], - "allowAllCompanies": false,
- "firstName": "Test",
- "lastName": "Bond",
- "middleName": "Neo",
- "userName": "TestUser",
- "password": "*******",
- "gender": "M",
- "dob": "2001-12-31T12:00:00",
- "age": 29,
- "customerRefId": "abcdef123456",
- "email": "dr1231@nuvizz.com",
- "cdlNumber": 5112747890,
- "mobileNumber": 4048621577,
- "name": "Cumberland Mall",
- "address1": "2860 Cumberland Mall",
- "address2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": 30339,
- "country": "USA",
- "vendorId": "abcdef123456",
- "vehicle": {
- "type": "Ambulance",
- "description": "vehicle used as ambulance",
- "vin": "VEHL1234",
- "numberPlate": "804623F",
- "gvwr": 6600,
- "capacity": 100,
- "tireSize": 22.5,
- "maxCubicFeet": 270,
- "boxLWH": "10*10*10",
- "insuranceDate": "2020-12-31T00:00:00.000Z",
- "vehiclePicPath": "vehicle/vehiclepic/document/COMPCODE/43221",
- "registrationExpiryDate": "2030-12-31T00:00:00.000Z",
- "insuranceExpiryDate": "2030-12-31T00:00:00.000Z",
- "insuranceCompanyName": "BAJAJ",
- "insurancePolicyNbr": "INS2345",
- "insuranceLimit": 2
}, - "passwordNeverExpires": false,
- "forcePwdChg": false,
- "accountLocked": false,
- "accountNumber": "56A31D",
- "profilePicPath": "/document/profile/12345",
- "documents": [
- "/document/userdocs/12345",
- "/document/userdocs/12346"
], - "groupNames": [
- "MEMBERADMIN",
- "DRIVER"
], - "assignmentType": 1,
- "enabled": true,
- "unableToUseApp": true,
- "licenseAuthority": "DMV",
- "licenseExpirationDttm": "2001-12-31T12:00:00",
- "licenseState": "Georgia",
- "phoneNumber": "4048621577",
- "smsNumber": "4048621577",
- "userKey": "Client assign key",
- "profilePic": "Base64 png image",
- "ref1": "reference1",
- "ref2": "reference2",
- "ref3": "reference3",
- "userRoles": [
- {
- "role": "MemberAdmin"
}, - {
- "role": "DI_Dispatcher"
}, - {
- "role": "DI_Driver"
}, - {
- "role": "DI_Inquiry"
}, - {
- "role": "DI_Integration"
}, - {
- "role": "DI_Receiver"
}
], - "sendInvite": false,
- "settlementRequired": "YES",
- "title": "DRIVER",
- "driverPermission": "YES",
- "salesPermission": "NO",
- "startDate": "2024-12-01",
- "endDate": "2024-12-02",
- "driverNo": 2456,
- "contractExpDate": "2024-12-30",
- "medCardExpDate": "2024-12-30"
}
]
}
null
With the User API, partners will be able to create, modify and disable users on the system.
User Roles | Comments |
---|---|
MemberAdmin | This is a super admin user for a company and this user can Create new users Access to all admin functions within the system. User rights include Create/enable/disable new/existing users. Able to create/edit/update new filters, reports, and dashboards. No access to driver app |
DI_Receiver | With this role, the user will be able to login to the nuStockIt app and perform the action like Receive cartons Load returns |
DI_Integration | This is the Integration user role and can, Upload and interface load data into the system. Restricted/limited access to portal screens. No access to driver app. Cannot create/update new/existing users on platform |
DI_Inquiry | This is a view-only user role and the user can only have view-only access to specific portal screens,No access to driver app. For eg., the user will be able to access the various screens but will be prohibited from making any updates/changes on any of the portal screens |
DI_Driver | With this role, the user will be able to login to the driver app and perform the actions like, execute assigned loads/routes on the driver app (POD capture etc). No access to the portal. No edits/updates can be done to the loads assigned for execution on the app with this role |
DI_Dispatcher | The user can Login to the portal with the credentials provided. User access include create/enable/disable new/existing users. Perform all dispatcher functions required on the portal like create/edit/update loads/stops, assign /unassign drivers and carriers Restrictions included when creating/editing filters, reports, and dashboards. No access to driver app |
companyCode required | string <= 50 characters CompanyCode to which the user belongs |
required | object (User) |
profPic | string <binary> profile image |
vehPic | string <binary> vehicle image |
documents | Array of strings <binary> user document images |
{ "user": { "id": "abcdef123456", "userId": 12345, "allowedFacilities": [ "FAC-1", "FAC-2" ], "defaultFacility": "FAC-1", "allowAllFacilites": false, "allowedCompanies": [ "COMPCODE-1", "COMPCODE-2" ], "allowAllCompanies": false, "firstName": "Test", "lastName": "Bond", "middleName": "Neo", "userName": "TestUser", "password": "********", "gender": "M", "dob": "2001-12-31T12:00:00", "age": 29, "customerRefId": "abcdef123456", "email": "dr1231@nuvizz.com", "cdlNumber": 5112747890, "mobileNumber": 4048621577, "address": { "name": "Cumberland Mall", "addr1": "2860 Cumberland Mall", "addr2": "Shop 300", "city": "Atlanta", "state": "GA", "zip": 30339, "country": "USA", "landmark": "Hub001" }, "accountStatus": "ENABLED", "vendorId": "abcdef123456", "vehicle": { "type": "Ambulance", "description": "vehicle used as ambulance", "vin": "VEHL1234", "numberPlate": "804623F", "gvwr": 6600, "capacity": 100, "tireSize": 22.5, "maxCubicFeet": 270, "boxLWH": "10*10*10", "insuranceDate": "2020-12-31T00:00:00.000Z", "vehiclePicPath": "vehicle/vehiclepic/document/COMPCODE/43221", "registrationExpiryDate": "2030-12-31T00:00:00.000Z", "insuranceExpiryDate": "2030-12-31T00:00:00.000Z", "insuranceCompanyName": "BAJAJ", "insurancePolicyNbr": "INS2345", "insuranceLimit": 2 }, "passwordNeverExpires": false, "forcePwdChg": false, "accountLocked": false, "accountNumber": "56A31D", "profilePicPath": "/document/profile/12345", "documents": [ "/document/userdocs/12345", "/document/userdocs/12346" ], "groupNames": [ "MEMBERADMIN", "DRIVER" ], "assignmentType": 1, "enabled": true, "unableToUseApp": true, "licenseAuthority": "DMV", "licenseExpirationDttm": "2001-12-31T12:00:00", "licenseState": "Georgia", "phoneNumber": "4048621577", "smsNumber": "4048621577", "userKey": "Client assign key", "profilePic": "Base64 png image", "ref1": "reference1", "ref2": "reference2", "ref3": "reference3", "userRoles": [ { "role": "MemberAdmin" }, { "role": "DI_Dispatcher" }, { "role": "DI_Driver" }, { "role": "DI_Inquiry" }, { "role": "DI_Integration" }, { "role": "DI_Receiver" } ], "sendInvite": false, "settlementRequired": "YES", "title": "DRIVER", "driverPermission": "YES", "salesPermission": "NO", "startDate": "2024-12-01", "endDate": "2024-12-02", "driverNo": 2456, "contractExpDate": "2024-12-30", "medCardExpDate": "2024-12-30" }, "profPic": "multipart data of the user profile pic", "vehPic": "multipart data of the user vehicle pic", "documents": "array of multipart data of the all the user related documents" }
null
With the User API, partners will be able to update/modify the user documents.
companyCode required | string <= 50 characters CompanyCode to which the user belongs |
id | string <= 24 characters Unique alpha numeric database generated Id for the user. |
userId | integer [ 0 .. 999999 ] Unique system generated integer Id for the User. Note: Either id or userId required to update the user documents. |
imageType | string <= 15 characters
|
documents | Array of strings <binary> user document images |
{ "userId": 1234, "imageType": "PROF_PIC", "documents": "array of multipart data of the all the user related documents" }
null
With the User API, partners will be retreive a list of users on the system. operationId: userList
companyCode required | string <= 50 characters CompanyCode to which the user belongs |
customerRefId | string <= 50 characters Unique alpha numeric value used to refer a Customer for which the user is associated with |
customerAccNbr | string <= 50 characters Account Number of the customer |
object (List Request) | |
object (SearchCriteria) |
{- "customerRefId": "abcdef123456",
- "pageInfo": {
- "pageSize": 20,
- "page": 1,
- "maxResult": 20
}, - "searchCriteria": {
- "name": "Neon jon",
- "groupNames": [
- "MEMBERADMIN",
- "DRIVER"
], - "vendorId": [
- "6671582fce033574a13258d2",
- "6671582fce033574a13258d2"
], - "email": "dcqa@nuvizz.com",
- "userRoles": [
- "Owner",
- "Admin"
], - "status": "-1"
}
}
{- "totalRecords": 81,
- "defaultSize": 20,
- "currentPageSize": 1,
- "pageNo": 5,
- "users": [
- {
- "id": "string",
- "userId": 1234,
- "title": "string",
- "firstName": "Test",
- "lastName": "Bond",
- "userName": "TestUser",
- "email": "dr1231@nuvizz.com",
- "middleName": "Neo",
- "allowedFacilities": [
- "FAC-1",
- "FAC-2"
], - "defaultFacility": "FAC-1",
- "allowAllFacilites": false,
- "defaultCompany": "string",
- "allowedCompanies": [
- "COMPCODE-1",
- "COMPCODE-2"
], - "companys": [
- {
- "value": "64a66315f820ad378784f425",
- "text": "contract1",
- "reference": "ACTIVE"
}
], - "allowAllCompanies": false,
- "password": "********",
- "gender": "Male",
- "dob": "2001-12-31",
- "age": 29,
- "accountStatus": "string",
- "customerRefId": "abcdef123456",
- "vendorId": "abcdef123456",
- "vehicle": {
- "type": "string",
- "description": "string",
- "vin": "string",
- "numberPlate": "string",
- "gvwr": "string",
- "capacity": 0,
- "tireSize": 0,
- "maxCubicFeet": 0,
- "boxLWH": "string",
- "insuranceDate": "string",
- "vehiclePicPath": "vehicle/vehiclepic/document/COMPCODE/43221",
- "registrationExpiryDate": "string",
- "insuranceExpiryDate": "string",
- "insuranceCompanyName": "string",
- "insurancePolicyNbr": "string",
- "insuranceLimit": 0,
- "lastVehicleInsuranceDate": "string"
}, - "userType": "CUSTOMER",
- "cdlNumber": 5112747890,
- "passwordNeverExpires": false,
- "forcePwdChg": false,
- "address1": "665 Washington Way",
- "address2": "Liberty Drive",
- "city": "Cumming",
- "state": "GA",
- "zip": "30080",
- "country": "USA",
- "accountNumber": "56A31D",
- "groupNames": [
- "MEMBERADMIN",
- "DRIVER"
], - "certificationAndSkills": [
- "Driver trainer"
], - "assignmentType": 1,
- "unableToUseApp": true,
- "licenseAuthority": "DMV",
- "licenseExpirationDttm": "2001-12-31",
- "licenseState": "Georgia",
- "mobileNumber": 4048621577,
- "userKey": "Client assign key",
- "profilePicPath": "document/COMPCODE/43221",
- "documents": [
- "document/COMPCODE/43233",
- "document/COMPCODE/43232"
], - "documentInfos": [
- {
- "guid": "string",
- "name": "string",
- "code": "string",
- "number": 0,
- "issueDate": "string",
- "expiryDate": "string"
}
], - "userRoles": [
- {
- "role": "MemberAdmin"
}
], - "ref1": "UR1001",
- "ref2": "UR1002",
- "ref3": "UR1003",
- "externalId": "UEI001",
- "accountLocked": false,
- "settlementRequired": "stri",
- "lastUpdateDTTM": "2020-04-21T12:00:00",
- "sendInvite": false,
- "sendReInvite": false,
- "customerPortalAccess": "INACTIVE",
- "driverPermission": "stri",
- "salesPermission": "stri",
- "startDate": "string",
- "endDate": "string",
- "additionalEmails": "dr1231@nuvizz.com,dr123@nuvizz.com",
- "driverNumber": "string",
- "medicalCardExpiryDate": "string",
- "contractExpiryDate": "string",
- "accessType": "widget",
- "authType": "string",
- "accessKey": "ArxE4QCXzIXw18Rv23nTtQ",
- "accessSecret": "YSk4mGUz3sI4v3cJ378",
- "description": "string",
- "allowRefreshToken": true,
- "grants": [
- "stop_mgmt",
- "stop_inq"
], - "widgetName": "string",
- "allowChildCompAccess": false,
- "allowBPAccess": false,
- "allowedDomains": [
- "nuvizz.com",
- "nuvizzapps.com"
], - "allowedIPAddresses": [
- "10.104.128.99",
- "10.104.128.100"
], - "assignedGroups": "memberadmin",
- "enabled": true,
- "phoneNumber": 4048621577,
- "smsNumber": 4048621577,
- "profilePic": "Base64 png image"
}
]
}
Partners will retreive the profile of a user on the system. operationId: userInfo
companyCode required | string <= 50 characters CompanyCode to which the user belongs |
userName required | string <= 100 characters Unique username of the user to be retrieved |
id | string <= 30 characters Unique alpha numeric database generated Id for the user. |
// Import classes: import io.swagger.client.ApiClient; import io.swagger.client.ApiException; import io.swagger.client.Configuration; import io.swagger.client.auth.*; import io.swagger.client.api.UserApiApi; ApiClient defaultClient = Configuration.getDefaultApiClient(); // Configure HTTP basic authorization: Basic Authentication HttpBasicAuth Basic Authentication = (HttpBasicAuth) defaultClient.getAuthentication("Basic Authentication"); Basic Authentication.setUsername("YOUR USERNAME"); Basic Authentication.setPassword("YOUR PASSWORD"); UserApiApi apiInstance = new UserApiApi(); String companyCode = "ABC"; // String | CompanyCode to which the user belongs try { UserListResponse result = apiInstance.userInfo(companyCode); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling UserApiApi#userList"); e.printStackTrace(); }
{- "id": "string",
- "userId": 1234,
- "title": "string",
- "firstName": "Test",
- "lastName": "Bond",
- "userName": "TestUser",
- "email": "dr1231@nuvizz.com",
- "middleName": "Neo",
- "allowedFacilities": [
- "FAC-1",
- "FAC-2"
], - "defaultFacility": "FAC-1",
- "allowAllFacilites": false,
- "defaultCompany": "string",
- "allowedCompanies": [
- "COMPCODE-1",
- "COMPCODE-2"
], - "companys": [
- {
- "value": "64a66315f820ad378784f425",
- "text": "contract1",
- "reference": "ACTIVE"
}
], - "allowAllCompanies": false,
- "password": "********",
- "gender": "Male",
- "dob": "2001-12-31",
- "age": 29,
- "accountStatus": "string",
- "customerRefId": "abcdef123456",
- "vendorId": "abcdef123456",
- "vehicle": {
- "type": "string",
- "description": "string",
- "vin": "string",
- "numberPlate": "string",
- "gvwr": "string",
- "capacity": 0,
- "tireSize": 0,
- "maxCubicFeet": 0,
- "boxLWH": "string",
- "insuranceDate": "string",
- "vehiclePicPath": "vehicle/vehiclepic/document/COMPCODE/43221",
- "registrationExpiryDate": "string",
- "insuranceExpiryDate": "string",
- "insuranceCompanyName": "string",
- "insurancePolicyNbr": "string",
- "insuranceLimit": 0,
- "lastVehicleInsuranceDate": "string"
}, - "userType": "CUSTOMER",
- "cdlNumber": 5112747890,
- "passwordNeverExpires": false,
- "forcePwdChg": false,
- "address1": "665 Washington Way",
- "address2": "Liberty Drive",
- "city": "Cumming",
- "state": "GA",
- "zip": "30080",
- "country": "USA",
- "accountNumber": "56A31D",
- "groupNames": [
- "MEMBERADMIN",
- "DRIVER"
], - "certificationAndSkills": [
- "Driver trainer"
], - "assignmentType": 1,
- "unableToUseApp": true,
- "licenseAuthority": "DMV",
- "licenseExpirationDttm": "2001-12-31",
- "licenseState": "Georgia",
- "mobileNumber": 4048621577,
- "userKey": "Client assign key",
- "profilePicPath": "document/COMPCODE/43221",
- "documents": [
- "document/COMPCODE/43233",
- "document/COMPCODE/43232"
], - "documentInfos": [
- {
- "guid": "string",
- "name": "string",
- "code": "string",
- "number": 0,
- "issueDate": "string",
- "expiryDate": "string"
}
], - "userRoles": [
- {
- "role": "MemberAdmin"
}
], - "ref1": "UR1001",
- "ref2": "UR1002",
- "ref3": "UR1003",
- "externalId": "UEI001",
- "accountLocked": false,
- "settlementRequired": "stri",
- "lastUpdateDTTM": "2020-04-21T12:00:00",
- "sendInvite": false,
- "sendReInvite": false,
- "customerPortalAccess": "INACTIVE",
- "driverPermission": "stri",
- "salesPermission": "stri",
- "startDate": "string",
- "endDate": "string",
- "additionalEmails": "dr1231@nuvizz.com,dr123@nuvizz.com",
- "driverNumber": "string",
- "medicalCardExpiryDate": "string",
- "contractExpiryDate": "string",
- "accessType": "widget",
- "authType": "string",
- "accessKey": "ArxE4QCXzIXw18Rv23nTtQ",
- "accessSecret": "YSk4mGUz3sI4v3cJ378",
- "description": "string",
- "allowRefreshToken": true,
- "grants": [
- "stop_mgmt",
- "stop_inq"
], - "widgetName": "string",
- "allowChildCompAccess": false,
- "allowBPAccess": false,
- "allowedDomains": [
- "nuvizz.com",
- "nuvizzapps.com"
], - "allowedIPAddresses": [
- "10.104.128.99",
- "10.104.128.100"
], - "assignedGroups": "memberadmin",
- "enabled": true,
- "phoneNumber": 4048621577,
- "smsNumber": 4048621577,
- "profilePic": "Base64 png image"
}
This request will update the status of the User operationId: updateStatus
companyCode required | string <= 50 characters CompanyCode to which the user belongs |
importRequest
id | string <= 30 characters Unique alpha numeric database generated Id for the user. |
userName required | string <= 50 characters Login user name. |
enabled required | boolean User status is true or false |
{- "id": "string",
- "userName": "string",
- "enabled": true
}
{- "status": "Success"
}
Add customer note
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Customer belongs to |
Add Notes
entity required | string <= 50 characters Entity Type of the Object
|
entityCode | string <= 20 characters Unique alpha numeric value used to refer a Entity.
like |
entityRef | string <= 24 characters Unique alpha numeric system generated value used to refer a Entity. Note: In query parameters either entityCode or entityRef is mandatory. |
object (Note) |
{- "entity": "ACC01",
- "entityCode": "ACC01",
- "entityRef": "abcdd123",
- "note": {
- "refType": "CUSTOMER or INVOICE",
- "tag": "Memo",
- "comment": "Don't ring the bell"
}
}
null
Notes List
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Notes belongs to |
entity required | string <= 50 characters Entity Type of the Object
|
entityCode | string <= 50 characters Unique alpha numeric value used to refer a Entity.
like |
entityRef | string <= 50 characters Unique alphanumeric Id generated in nuDeliverit system to refer specific Entity. Note: In query parameters either entityCode or entityRef is mandatory. |
Note List Request
object (List Request) | |
refType | string <= 20 characters Search Criteria for Type of the note |
tag | string <= 20 characters Search Criteria for Tag Type of the note |
addedOn | string <= 20 characters Search Criteria for Date added of the note |
addedBy | string <= 20 characters Search Criteria for User of the note |
{- "listReq": {
- "pageSize": 20,
- "page": 1,
- "maxResult": 30
}, - "refType": "CUSTOMER",
- "tag": "memo",
- "addedOn": "1d",
- "addedBy": "admin"
}
{- "totalRecords": 81,
- "defaultSize": 20,
- "currentPageSize": 1,
- "pageNo": 5,
- "notes": [
- {
- "refType": "CUSTOMER or INVOICE",
- "tag": "Memo",
- "comment": "Don't ring the bell",
- "addedBy": "Smith",
- "lastUpdateDTTM": "2024-03-21T12:00:00"
}
]
}
This API is used when external systems perform Route Planning and send the route info to be updated. Route Plan enables external route planning tools to integrate their route plans into the system. Existing stops are
planned
orun-planned
serviceName required | string <= 100 characters serviceName refer to custom integration for the company, set to |
companyCode required | string <= 50 characters Company Code to which the Route belongs to |
companyCode required | string <= 50 characters CompanyCode from application |
required | object (Route) |
{- "companyCode": "XYZ",
- "route": {
- "loadHeader": {
- "loadNbr": "Load_PB_911",
- "earliestStartDttm": "2001-12-31T12:00:00",
- "latestStartDttm": "2001-12-31T12:00:00",
- "signatureRequired": true,
- "originAddr1": "1000 Circle 75 Pkwy",
- "originAddr2": "Suite#700",
- "originCity": "Atlanta",
- "originState": "GA",
- "originZip": "30339",
- "originCountry": "US",
- "origin": "Nuvizz",
- "originName": "Nuvizz Inc",
- "originPhoneNumber": "4049371971",
- "loadTimeZone": "EST",
- "originLatitude": 0,
- "originLongitude": 0,
- "depot": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}
}, - "masterBol": "001",
- "pronbr": "002",
- "reference": "112345",
- "reference2": "456789",
- "reference3": "123456",
- "sealNbr": "01",
- "stopSeqOrder": 1,
- "totalCartons": 1,
- "totalPallets": 1,
- "tractorNbr": "54331",
- "trailerNbr": "12 I 45",
- "trailerSize": 456,
- "trailerType": 456,
- "volume": 10,
- "volumeUOM": "CBM",
- "weight": 100,
- "weightUOM": "Kg",
- "contractCode": "007",
- "prePlannedLoadDistance": 10,
- "prePlannedLoadDuration": 10,
- "congestionFactor": 1.9,
- "comments": [
- {
- "commentType": "01",
- "commentDescription": "Load is deliver to multiple customer"
}, - {
- "commentType": "01",
- "commentDescription": "Get signature for load"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}, - {
- "keyField": "Cost",
- "keyValue": "High"
}
], - "documents": [
- {
- "description": "BOL",
- "dispositionType": 11,
- "documentData": "binday file data",
- "documentExtType": "pdf",
- "documentName": "Load BOL",
- "documentType": 1,
- "documentCategory": "FADR",
- "reference": "dc9382ee-3fdb-4d93-ad15-863ddde9eaea",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": 0
}
]
}
]
}, - "planStops": [
- {
- "stopNbr": "Stop001",
- "from": {
- "seq": 1,
- "schedule": {
- "timeFrom": "2022-06-21T13:00:00",
- "timeTo": "2022-06-21T13:30:00",
- "timeZone": "GMT",
- "estimatedDuration": 5
}
}, - "to": {
- "seq": 3,
- "schedule": {
- "timeFrom": "2022-06-21T15:00:00",
- "timeTo": "2022-06-21T15:30:00",
- "timeZone": "GMT",
- "estimatedDuration": 3
}
}
}, - {
- "stopNbr": "Stop002",
- "from": {
- "seq": 2,
- "schedule": {
- "timeFrom": "2022-06-21T13:50:00",
- "timeTo": "2022-06-21T14:10:00",
- "timeZone": "GMT",
- "estDuration": 5
}
}, - "to": {
- "seq": 4,
- "schedule": {
- "timeFrom": "2022-06-21T15:50:00",
- "timeTo": "2022-06-21T16:10:00",
- "timeZone": "GMT",
- "estDuration": 3
}
}
}
], - "loadAssignment": {
- "carrierCode": "XYZBP",
- "assignmentCriteria": 1,
- "driverCdl": 98724890,
- "driverEmail": "driver12@test.com",
- "driverName": "admin",
- "driverUserName": "driver"
}
}
}
{- "status": "Success"
}
This API provides a list of available appointment/service capacities. Given the an address and an optional order#, a list of available timeslots are sent back in the response. A subsequent API for reservation can be performed to reserve a time slot.
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the appointment slots belongs to |
Get available appointment slots request
stopId | string <= 50 characters Unique alpha numeric system generated id for the order. Required only when placing a change/update to an existing order (stopNbr) in the system |
stopNbr | string <= 20 characters Unique alpha numeric value that refers to a Stop. |
apptStartDate | string <= 10 characters Appointment Start Date yyyy-mm-dd format |
object (Appointment order info) |
{- "stopNbr": "ORDER0001",
- "stopId": "abcd123340707",
- "apptStartDate": "2023-09-25",
- "stopInfo": {
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "weight": 100,
- "weightUOM": "kg",
- "volume": 50,
- "volumeUOM": "liter",
- "totalPallets": 25,
- "totalCartons": 10,
- "quantity": 5,
- "partnerCode": "ABC",
- "serviceTime": 10,
- "scheduleAttribute": "xyz"
}
}
{- "stopNbr": "ORDER0001",
- "stopId": "abcd123340707",
- "stopInfo": {
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "weight": 100,
- "weightUOM": "kg",
- "volume": 50,
- "volumeUOM": "liter",
- "totalPallets": 25,
- "totalCartons": 10,
- "quantity": 5,
- "partnerCode": "ABC",
- "serviceTime": 10,
- "scheduleAttribute": "xyz"
}, - "serviceRegion": "eastzone",
- "apptSlots": [
- {
- "apptDate": "2023-09-25",
- "timeSlots": [
- {
- "slotId": "123",
- "startTime": "09:30",
- "endTime": "18:30",
- "timeZone": "US/Eastern"
}, - {
- "slotId": "456",
- "startTime": "00:00",
- "endTime": "23:59",
- "timeZone": "US/Eastern"
}
]
}, - {
- "apptDate": "2023-09-26",
- "timeSlots": [
- {
- "slotId": "123",
- "startTime": "09:30",
- "endTime": "18:30",
- "timeZone": "US/Eastern"
}
]
}
]
}
This API reserves the capacity for the Timeslot indicated. The reservation can be for an order that yet to be placed (OrderId = Not Available). The reservation is made for a temporary hold for {apptTTL} minutes.
It is necessary to indicate the capacity of the order in terms of weight/ volume/ qty/ service time. If the capacity/appt reservation does not contain any of the elements, then a reservation is not made.
The capacity reservation request can be made for an existing order as well as yet to be confirmed order.
For an existing order, the orderId must be mentioned. If the reservation request can be honored, the previous appt (if exists) will be released and the new appt will be updated directly on the order.
RequestBody can be provided for the following groups and Atleast one of the field is required
- stopId - First preference
- stopInfo - Second preference
RequestBody can be provided for the following groups and Atleast one of the field is required
- timeslotId
- apptId
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the appointment slots belongs to |
Set appointment request
timeSlotId | string <= 50 characters Unique ID define in nudeliverit,This id is provided in Get Available Appointment request. Required either timeSlotId or apptId. Mandatory, for the Set Appointment request, which is reservation or confirmation (internal to nuDeliverit) request |
stopId | string <= 50 characters Unique ID define in nudeliverit for the Stop. Required only when placing a change/update to an existing Stop (stopNbr) in the system |
stopNbr | string <= 20 characters Unique alpha numeric value that refers to a Stop. |
apptId | string <= 50 characters Unique ID define in nudeliverit for the appointment. This field for nuDeliverit internal purpose. Required to confirm appointment slot, after Stop create or update |
apptStartDate | string <= 10 characters Appointment Start Date yyyy-mm-dd format |
comment | string <= 200 characters Comments provided during the appointment scheduling. |
object (Appointment order info) |
{- "timeSlotId": "123",
- "stopNbr": "ORDER0001",
- "stopId": "abcd123340707",
- "apptStartDate": "2023-09-25",
- "stopInfo": {
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "weight": 100,
- "weightUOM": "kg",
- "volume": 50,
- "volumeUOM": "liter",
- "totalPallets": 25,
- "totalCartons": 10,
- "quantity": 5,
- "partnerCode": "ABC",
- "serviceTime": 10,
- "scheduleAttribute": "xyz"
}
}
{- "stopNbr": "ORDER0001",
- "stopId": "abcd123340707",
- "apptStatus": "ONHOLD",
- "apptTTL": 15,
- "apptId": "12345",
- "serviceRegion": "eastzone",
- "stopInfo": {
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "weight": 100,
- "weightUOM": "kg",
- "volume": 50,
- "volumeUOM": "liter",
- "totalPallets": 25,
- "totalCartons": 10,
- "quantity": 5,
- "partnerCode": "ABC",
- "serviceTime": 10,
- "scheduleAttribute": "xyz"
}
}
This API cancels appointment for order. RequestBody can be provided for the following groups and Atleast one of the field is required
- stopIds - First preference
- stopNbrs - Second preference
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the appointment belongs to |
Cancel appointment request
stopIds | Array of strings <= 20 items [ items <= 50 characters ] List of unique alpha numeric system generated ids for stops. |
stopNbrs | Array of strings <= 20 items [ items <= 50 characters ] List of unique alpha numeric values that refers to stops. |
comment | string <= 200 characters Comments provided during cancelling appointment scheduling. |
{- "stopIds": [
- "abcd123340777",
- "abcd123340999"
], - "stopNbrs": [
- "ORDER0001",
- "ORDER0002"
], - "comment": "Not available"
}
null
This API is used to trigger SMS to customer for scheduling appointment. RequestBody can be provided for the following groups and Atleast one of the field is required
- stopIds - First preference
- stopNbrs - Second preference
companyCode required | string <= 50 characters NuDeliverIt Company code. |
Trigger customer appointment Request
stopIds | Array of strings <= 20 items [ items <= 50 characters ] List of unique alpha numeric system generated ids for stops. |
stopNbrs | Array of strings <= 20 items [ items <= 50 characters ] List of unique alpha numeric values that refers to stops. |
{- "stopIds": [
- "abcd123340777",
- "abcd123340999"
], - "stopNbrs": [
- "ORDER0001",
- "ORDER0002"
]
}
null
Customer Order API is used to create a request to transport goods from a customer pickup location to a drop off location. Depending on the geographic locations, cross dock facilities involved in moving the goods can be provided to generate multiple shipments tied to the customer order.
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Stop belongs to |
orderNbr required | string <= 100 characters Unique alpha numeric value used to refer a Order |
// Import classes: import com.nuvizz.openapi.inbound.handler.ApiClient; import com.nuvizz.openapi.inbound.handler.ApiException; import com.nuvizz.openapi.inbound.handler.Configuration; import com.nuvizz.openapi.inbound.handler.auth.*; import com.nuvizz.openapi.inbound.handler.models.*; import com.nuvizz.openapi.inbound.handler.CustomerOrderApiApi; public class Example { public static void main(String[] args) { ApiClient defaultClient = Configuration.getDefaultApiClient(); defaultClient.setBasePath("https://contact-support.nuvizz.com/api-gateway/webservices/nudeliverit/v6"); // Configure HTTP basic authorization: Basic Authentication HttpBasicAuth Basic Authentication = (HttpBasicAuth) defaultClient.getAuthentication("Basic Authentication"); Basic Authentication.setUsername("YOUR USERNAME"); Basic Authentication.setPassword("YOUR PASSWORD"); CustomerOrderApiApi apiInstance = new CustomerOrderApiApi(defaultClient); String companyCode = "companyCode_example"; // String | Code of the nuDeliverIt Company to which the Stop belongs to String orderNbr = "orderNbr_example"; // String | Unique alpha numeric value used to refer a Order try { OrderSuccessResponse result = apiInstance.getOrderDetail(companyCode, orderNbr); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling CustomerOrderApiApi#getOrderDetail"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } }
{- "Order": [
- {
- "orderNbr": "Order039",
- "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "to": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "txnRef": 45367463,
- "seq": "1",
- "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "EST",
- "srvcTimeCode": "SRVC01",
- "estimatedDuration": "20",
- "timeConstraint": "PREFERRED"
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
], - "feedbackForm": "CustomerSurvey",
- "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}, - "captureInfo": {
- "captureDocuments": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
], - "captureImages": [
- {
- "name": "Doc/Image",
- "required": "MANDATORY / OPTIONAL"
}
]
}
}, - "shipForBP": "1163",
- "shipperCode": "S201",
- "consAttribute": "DNCA26R1S1021820",
- "shipmentNbr": "ShipmentNbr003",
- "doConfirmation": "SCAN-VER",
- "puConfirmation": "SCAN-VER",
- "originHub": "LM1",
- "xDock": "ATL,PTL",
- "trackHubXfr": "01",
- "accountNumber": "ACC01",
- "billTo": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressType": "COM",
- "label": "PRIMARY",
- "storeNbr": "ST123",
- "custAccNbr": "CUST0090",
- "fullAddress": "13, 2nd Main Rd, NS Palya, Stage 2, BTM Layout, Bengaluru, Karnataka 560076",
- "saveAddress": true
}, - "bol": "MBOL39203",
- "freightTerms": "new DC",
- "proNumber": "TC123",
- "reference1": "TCS1001",
- "reference2": "TCS1002",
- "orderPriority": "01",
- "totalCartons": "10",
- "totalPallets": "8",
- "volume": "10",
- "volumeUOM": "CBM",
- "weight": "100",
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "stopGeofenceRadius": 150,
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "totalPrice": "123.85",
- "orderAccessorials": [
- {
- "code": "ACC",
- "comments": "ACC report for Stop",
- "type": "DO",
- "calcUnits": 10,
- "matchUnits": 25
}
], - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": "1",
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "palletID": "235AZRFTG",
- "orderDate": "2019-12-10",
- "toteID": 132245565,
- "trailerCode": "tcl",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "deliveryType": "DO",
- "customerPO": "100PO",
- "custRouteNbr": 151,
- "custStopNbr": 135,
- "customerOrderNbr": 124234356,
- "invoiceNbr": 102345001,
- "invoiceDate": "2019-12-09",
- "pickingNumber": "904729",
- "accountNumber": "ACC01",
- "confirmationType": "P",
- "lineType": 1,
- "referenceText": "Fragile item",
- "originalLineNumber": "10",
- "serviceCategory": "UNITS@20151021-0047-PALLET_1-003",
- "volume": "10",
- "volumeUOM": "cubic meters",
- "weight": "100",
- "weightUOM": "kilograms",
- "unitPrice": 40.1,
- "productCategory": "DRY",
- "productSubCategory": "Boxes & Trays",
- "substituteItem": true,
- "commitmentItem": true,
- "redelivery": true,
- "earliestDTTM": "2019-03-25T10:30:00",
- "latestDTTM": "2019-03-25T10:33:00",
- "length": "123.85",
- "lengthUOM": "inch",
- "width": "123.85",
- "widthUOM": "inch",
- "height": "123.85",
- "heightUOM": "inch",
- "criticalDimension": "123.85",
- "criticalDimensionUOM": "inch",
- "consAttribute": "DNCA26R1S1021820",
- "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
]
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall",
- "commentTypeDescription": "Stop Deliver to Cumberland Mall",
- "addedByName": "John Smith",
- "addedOn": "2020-04-21T12:00:00"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "documentGuid": "2a9d954e-9d34-4534-a1da-2edb35890568",
- "createdDTTM": "2020-04-21T12:00:00",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
]
}
]
}
Import a Order for a certain nuDeliverItCompany
serviceName required | string <= 100 characters serviceName refer to custom integration for the company, set to "default" if not using a custom integration |
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Stop belongs to |
importRequest
companyCode required | string <= 20 characters Code of a nudeliverit Company to which the Order belongs to. |
required | Array of objects (Orders) <= 50 items |
{- "companyCode": "XYZ",
- "orders": [
- {
- "orderNbr": "Order039",
- "shipForBP": "1163",
- "shipperCode": "S201",
- "consAttribute": "DNCA26R1S1021820",
- "from": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "XXXX",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "to": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "In Cumberland Mall",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Jon",
- "email": "mike123@test.com",
- "phone": "4049371973",
- "sms": "4049371973"
}, - "schedule": {
- "timeFrom": "2020-04-21T12:00:00",
- "timeTo": "2020-04-21T16:00:00",
- "timeZone": "GMT",
- "estDuration": 20
}, - "workType": "CustomerSurveyForm",
- "signatureRequired": true,
- "imageRequired": false,
- "feedbackForm": "CustomerSurvey"
}, - "shipmentNbr": "ShipmentNbr003",
- "puConfirmation": "SKIP",
- "doConfirmation": "SCAN-VER",
- "originHub": "LM1",
- "trackHubXfr": "01",
- "accountNumber": "ACC01",
- "billTo": {
- "name": "test",
- "addr1": "1001 NOrth Taylor Road",
- "addr2": null,
- "city": "Rome",
- "state": "IL",
- "zip": "60446",
- "country": "US",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "bol": "MBOL39203",
- "freightTerms": "new DC",
- "proNumber": "TC123",
- "reference1": "TCS1001",
- "reference2": "TCS1002",
- "orderPriority": "01",
- "totalCartons": 10,
- "totalPallets": 8,
- "volume": 10,
- "volumeUOM": "CBM",
- "weight": 100,
- "weightUOM": "Kg",
- "scheduleAttribute": "10S1",
- "stopGeofenceRadius": 150,
- "criticalDimension": 123.85,
- "criticalDimensionUOM": "inch",
- "totalPrice": 123.85,
- "orderAccessorials": [
- {
- "code": "ACC",
- "comments": "ACC report for Stop"
}
], - "stopDetails": [
- {
- "product": "SK-1932A-BRN-900",
- "productIdentifier": "zx_24",
- "quantity": 1,
- "quantityUOM": "Cartons",
- "stopDetailSeq": 1,
- "palletID": "235AZRFTG",
- "orderDate": "2019-12-10",
- "toteID": "132245565",
- "trailerCode": "tcl",
- "ratingGroup": "018004789R",
- "signatureGroup": "SIG03",
- "deliveryType": "DO",
- "customerPO": "100PO",
- "custRouteNbr": "151",
- "custStopNbr": "135",
- "customerOrderNbr": "124234356",
- "invoiceNbr": "102345001",
- "invoiceDate": "2019-12-09",
- "pickingNumber": "904729",
- "accountNumber": "ACC01",
- "confirmationType": "P",
- "lineType": "01",
- "referenceText": "Fragile item",
- "originalLineNumber": "10",
- "serviceCategory": "UNITS@20151021-0047-PALLET_1-003",
- "volume": 10,
- "volumeUOM": "cubic meters",
- "weight": 100,
- "weightUOM": "kilograms",
- "unitPrice": 40.1,
- "productCategory": "DRY",
- "productSubCategory": "Boxes & Trays",
- "substituteItem": true,
- "commitmentItem": true,
- "redelivery": true,
- "earliestDTTM": "2019-03-25T10:30:00",
- "latestDTTM": "2019-03-25T10:33:00",
- "length": 123.85,
- "lengthUOM": "inch",
- "width": 123.85,
- "widthUOM": "inch",
- "height": 123.85,
- "heightUOM": "inch",
- "criticalDimension": 123.85,
- "criticalDimensionUOM": "inch",
- "consAttribute": "DNCA26R1S1021820",
- "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall"
}
]
}
], - "comments": [
- {
- "commentType": "01",
- "commentDescription": "Stop Deliver to Cumberland Mall"
}
], - "customAttributes": [
- {
- "keyField": "Ratings",
- "keyValue": "Good"
}
], - "documents": [
- {
- "description": "Delivery confirmation document",
- "dispositionType": "Requires Signature",
- "documentData": "png file",
- "documentExtType": "Velocity Template",
- "documentName": "DeliveryDocument",
- "documentType": "03",
- "documentCategory": "BOL",
- "reference": "fbaecf83-c13e-4246-8b54-cae18af3ea39",
- "docSignatories": [
- {
- "role": "DI_Driver",
- "signatoryName": "Customer",
- "optional": true
}
]
}
]
}
]
}
{- "status": "Success"
}
Delete/Reject a stop(in unplanned, created statuses)
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Stop/Order belongs to |
orderNbr required | string <= 20 characters Unique alpha numeric value that refers to a Order. |
reasonCode required | string <= 10 characters Code that refers to the particular nuDeliverit system code for canceling a order. |
reasonComments | string <= 500 characters Comments entered during the cancellation of a stop/order. |
{- "orderNbr": "S10001112",
- "reasonCode": "01",
- "reasonComments": "In-valid Stop details"
}
{- "status": "Success"
}
Customer API is used to create a request to retreive customer information. Customers represent the shipper who will be providing orders to the carriers.
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Customer belongs to |
accountNumber required | string <= 50 characters Unique alpha numeric value used to refer a Customer |
// Import classes: import com.nuvizz.openapi.inbound.handler.ApiClient; import com.nuvizz.openapi.inbound.handler.ApiException; import com.nuvizz.openapi.inbound.handler.Configuration; import com.nuvizz.openapi.inbound.handler.auth.*; import com.nuvizz.openapi.inbound.handler.models.*; import com.nuvizz.openapi.inbound.handler.CustomerApiApi; public class Example { public static void main(String[] args) { ApiClient defaultClient = Configuration.getDefaultApiClient(); defaultClient.setBasePath("https://contact-support.nuvizz.com/api-gateway/webservices/nudeliverit/v6"); // Configure HTTP basic authorization: Basic Authentication HttpBasicAuth Basic Authentication = (HttpBasicAuth) defaultClient.getAuthentication("Basic Authentication"); Basic Authentication.setUsername("YOUR USERNAME"); Basic Authentication.setPassword("YOUR PASSWORD"); CustomerApiApi apiInstance = new CustomerApiApi(defaultClient); String companyCode = "companyCode_example"; // String | Code of the nuDeliverIt Company to which the Customer belongs to String accountNumber = "accountNumber_example"; // String | Unique alpha numeric value used to refer a Customer try { CustomerSuccessResponse result = apiInstance.getCustomerDetail(companyCode, accountNumber); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling CustomerApiApi#getCustomerDetail"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } }
{- "Customer": [
- {
- "accountNumber": "ACC01",
- "name": "customer1",
- "updatedBy": "Smith",
- "lastUpdateDTTM": "2024-03-21T12:00:00",
- "billTo": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressInstructions": [
- "Don't ring the bell"
]
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}
}, - "customerPortalAccess": "ACTIVE",
- "subAccounts": [
- {
- "action": "CREATE",
- "guid": "abcdcdfgh",
- "name": "Freight Movement",
- "code": 81,
- "profDtls": [
- {
- "profName": "DEFAULT",
- "srvcLevels": [
- "SRVC-01",
- "SRVC-02"
]
}
], - "invDtl": {
- "invRef1": {
- "fldLabel": "BOL",
- "fldType": "PA",
- "placeholder": "Type here",
- "fldFormat": "AAA-9999",
- "defVal": "Inv1",
- "isReq": true,
- "options": [
- {
- "label": "Option1",
- "key": "key"
}
]
}, - "invRef2": {
- "fldLabel": "BOL",
- "fldType": "PA",
- "placeholder": "Type here",
- "fldFormat": "AAA-9999",
- "defVal": "Inv1",
- "isReq": true,
- "options": [
- {
- "label": "Option1",
- "key": "key"
}
]
}, - "invRef3": {
- "fldLabel": "BOL",
- "fldType": "PA",
- "placeholder": "Type here",
- "fldFormat": "AAA-9999",
- "defVal": "Inv1",
- "isReq": true,
- "options": [
- {
- "label": "Option1",
- "key": "key"
}
]
}, - "invRef4": {
- "fldLabel": "BOL",
- "fldType": "PA",
- "placeholder": "Type here",
- "fldFormat": "AAA-9999",
- "defVal": "Inv1",
- "isReq": true,
- "options": [
- {
- "label": "Option1",
- "key": "key"
}
]
}, - "invNbr": "INV001-",
- "invCycle": "On Demand",
- "invTag": "DEFAULT",
- "invPdfTemplateName": "DEFAULT",
- "invXlsTemplateName": "DEFAULT",
- "invEmailTemplateName": "DEFAULT",
- "invRecipients": [
- "abc@gmail.com",
- "def@gmail.com"
]
}, - "qbAccount": {
- "accountName": "Freight",
- "accountType": "Quick Book",
- "status": "Active/InActive",
- "id": 123456
}, - "pymtTerm": {
- "name": "Net 10",
- "pymtTermRefId": "234561000000abcdef234561",
- "sysSettingsRefId": "2122261000000abcdef234561",
- "netPymtTerm": 10
}
}
], - "contracts": [
- "PRO1",
- "PRO2"
], - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "profiles": [
- "PRO1",
- "PRO2"
], - "srvcLevels": [
- "SRVC-01",
- "SRVC-02"
], - "account": {
- "status": "OK",
- "balance": 10000,
- "creditLmt": 10000,
- "overLmtAmt": 10000,
- "warningLmt": 10000,
- "enforceLmt": 10000,
- "netPymtTerm": 10000,
- "invcFreq": 14,
- "lastPymtDttm": "2024-03-21T12:00:00",
- "lastOrderDttm": "2024-03-21T12:00:00",
- "lastInvcDttm": "2024-03-21T12:00:00"
}, - "status": "ACTIVE",
- "partnerCode": "ABC",
- "addresses": [
- {
- "label": "East Office",
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressInstructions": [
- "Don't ring the bell"
]
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}
}
], - "privateNotes": [
- {
- "refType": "CUSTOMER or INVOICE",
- "tag": "Memo",
- "comment": "Don't ring the bell",
- "addedBy": "Smith",
- "lastUpdateDTTM": "2024-03-21T12:00:00"
}
], - "orderEntryNote": {
- "refType": "CUSTOMER or INVOICE",
- "tag": "Memo",
- "comment": "Don't ring the bell",
- "addedBy": "Smith",
- "lastUpdateDTTM": "2024-03-21T12:00:00"
}
}
]
}
Import a Customer for a certain nuDeliverItCompany
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Customer belongs to |
importRequest
companyCode required | string <= 20 characters Code of a nudeliverit Company to which the Customer belongs to. |
required | Array of objects (Customers) <= 500 items |
{- "companyCode": "XYZ",
- "customers": [
- {
- "accountNumber": "ACC_123",
- "name": "John McClane",
- "status": "ACTIVE",
- "contracts": [
- {
- "contractCode": "CRT-1"
}, - {
- "contractCode": "CRT-2"
}
], - "billTo": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Near Milkyway Galaxy",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Customer",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}
}, - "addresses": [
- {
- "label": "Primary",
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Near Milkyway Galaxy",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Customer",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}, - "operatingHours": {
- "timeFrom": "01:30:00",
- "timeTo": "07:30:00"
}
}, - {
- "label": "East Office",
- "address": {
- "name": "test",
- "addr1": "1001 North Taylor Road",
- "addr2": null,
- "city": "Rome",
- "state": "IL",
- "zip": "60446",
- "country": "US",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Customer",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}, - "operatingHours": {
- "timeFrom": "01:30:00",
- "timeTo": "07:30:00"
}
}
]
}
]
}
{- "status": "Success",
- "apiResult": {
- "created": 10,
- "updated": 10,
- "failed": 10,
- "deleted": 10,
- "errors": [
- {
- "key": "StopNbr123",
- "msgs": [
- "string"
]
}
]
}, - "reasons": [
- {
- "description": "Company Code is required.",
- "errorCode": 1505,
- "errorLiteral": "nuvizz_entity_error_xxyy"
}
]
}
Import a Customer for a certain nuDeliverItCompany
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Customer belongs to |
importRequest
companyCode required | string <= 20 characters CompanyCode to which the User belongs |
required | object (Customer) |
{- "companyCode": "XYZ",
- "customers": [
- {
- "accountNumber": "ACC_123",
- "name": "John McClane",
- "status": "ACTIVE",
- "contracts": [
- {
- "contractCode": "CRT-1"
}, - {
- "contractCode": "CRT-2"
}
], - "billTo": {
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Near Milkyway Galaxy",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Customer",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}
}, - "addresses": [
- {
- "label": "Primary",
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Near Milkyway Galaxy",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Customer",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}, - "operatingHours": {
- "timeFrom": "01:30:00",
- "timeTo": "07:30:00"
}
}, - {
- "label": "East Office",
- "address": {
- "name": "test",
- "addr1": "1001 North Taylor Road",
- "addr2": null,
- "city": "Rome",
- "state": "IL",
- "zip": "60446",
- "country": "US",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Customer",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}, - "operatingHours": {
- "timeFrom": "01:30:00",
- "timeTo": "07:30:00"
}
}
]
}
]
}
{- "customer": {
- "customerId": "abcdd123",
- "accountNumber": "ACC01",
- "name": "customer1"
}, - "apiResult": {
- "created": 10,
- "updated": 10,
- "failed": 10,
- "deleted": 10,
- "errors": [
- {
- "key": "StopNbr123",
- "msgs": [
- "string"
]
}
]
}, - "reasons": [
- {
- "description": "Company Code is required.",
- "errorCode": 1505,
- "errorLiteral": "nuvizz_entity_error_xxyy"
}
]
}
List customer addresses for a certain nuDeliverItCompany
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Customer belongs to |
accountNbr required | string <= 50 characters Account Number of the customer |
APIRequest
pageSize required | number [ 0 .. 99999 ] Page size determinied by the application. |
page required | number [ 0 .. 99999 ] The current page number being queried. |
maxResult required | number [ 0 .. 99999 ] Maximum number of records per page. |
{- "pageSize": 20,
- "page": 1,
- "maxResult": 20
}
{- "totalRecords": 81,
- "defaultSize": 20,
- "currentPageSize": 1,
- "pageNo": 5,
- "addresses": [
- {
- "label": "East Office",
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Hub001",
- "latitude": 37.99878,
- "longitude": -87.7889879,
- "addressInstructions": [
- "Don't ring the bell"
]
}, - "contact": {
- "contactName": "Test-Stop",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974",
- "fax": "3489865974"
}, - "operatingHours": {
- "timeFrom": "01:33:00",
- "timeTo": "06:33:00"
}
}
]
}
Create or Update an address for a Customer for a certain nuDeliverItCompany
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Customer belongs to |
APIRequest
accountNumber required | string <= 20 characters Unique alpha numeric value used to refer a Customer. |
required | object (AddressDetail) |
{- "accountNumber": "ACC_123",
- "customerAddress": {
- "label": "Primary",
- "address": {
- "name": "Cumberland Mall",
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Near Milkyway Galaxy",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "contact": {
- "contactName": "Test-Customer",
- "email": "ghi@ghic.com",
- "phone": "3489865974",
- "sms": "3489865974"
}, - "operatingHours": {
- "timeFrom": "01:30:00",
- "timeTo": "07:30:00"
}
}
}
null
Remove an address for a Customer for a certain nuDeliverItCompany
companyCode required | string <= 50 characters Code of the nuDeliverIt Company to which the Customer belongs to |
APIRequest
accountNumber required | string <= 20 characters Unique alpha numeric value used to refer a Customer. |
addressLabel required | string <= 50 characters Unique alpha numeric value used to refer a Address label. |
{- "accountNumber": "ACC_123",
- "label": "Primary"
}
null
Demand API is used to create a request to create/update a demand.
serviceName required | string <= 100 characters serviceName refer to custom integration for the company, set to |
companyCode required | string <= 50 characters Company Code to which the Demand belongs to |
importRequest
companyCode required | string <= 50 characters CompanyCode from application |
demandPool required | string <= 50 characters DemandPool Name to which Demand belongs to. |
required | Array of objects (Demands) <= 2000 items |
{- "companyCode": "XYZ",
- "demandPool": "demandPool_001",
- "demands": [
- {
- "customerNbr": "UTE123",
- "locationType": "Delivery",
- "name": "John McClane",
- "fromAddress": {
- "name": "DC Grinnell - Interstate Acc",
- "addr1": "715 East St. South",
- "city": "GRINNELL",
- "state": "IA",
- "zip": "50112",
- "country": "US",
- "landmark": "Shop 10"
}, - "customerAddress": {
- "addr1": "2860 Cumberland Mall",
- "addr2": "Shop 300",
- "city": "Atlanta",
- "state": "GA",
- "zip": "30339",
- "country": "USA",
- "landmark": "Near Milkyway Galaxy",
- "latitude": 37.99878,
- "longitude": -87.7889879
}, - "daysOfWeek": "M",
- "dowConstraint": "PREFERRED",
- "timeWindow": {
- "start": "12:00:00",
- "end": "16:00:00"
}, - "operatingHours": {
- "timeFrom": "01:30:00",
- "timeTo": "07:30:00"
}, - "timeConstraint": "PREFERRED",
- "serviceFrequency": 3,
- "serviceType": "INCONSISTENT",
- "serviceWeeks": [
- 1
], - "intervalDays": 2,
- "serviceTime": 20,
- "priority": "High",
- "vehicleType": [
- "BOX"
], - "criticalDimension": 20,
- "quantity": 1,
- "quantityUOM": "Cartons",
- "volume": 10,
- "volumeUOM": "CBM",
- "weight": 100,
- "weightUOM": "Kg",
- "cartons": 10,
- "pallets": 10
}
]
}
{- "status": "Success"
}
This API is used to tender stops/routes to multiple carriers. If stop/route is already tendered to carriers, it will be recalled from those carriers and then tendered to requested carriers.
companyCode required | string <= 50 characters nuDeliverit company code |
tenderIssueRequest
carrierCodes required | Array of strings <= 100 items [ items <= 50 characters ] List of business partner/carrier codes to which tender is issued. |
tenderType | string <= 20 characters Types of tendering
|
tenderExpiryDttm | string <= 22 characters Tender expiry date and time in |
tenderExpiryTz | string <= 50 characters Time Zone of the tenderExpiryDttm. |
object (TenderStopRequest) | |
object (TenderRouteRequest) | |
comments | string <= 200 characters Comments for accepting/rejecting/recalling tender stop/route. |
reasonCode | string <= 50 characters Reason code for rejecting or recalling tender stop/route. |
{- "stops": {
- "stopIds": [
- "abcd123340777",
- "abcd123340999"
], - "stopNbrs": [
- "STOP0001",
- "STOP0002"
]
}, - "carrierCodes": [
- "ABCBP",
- "XYZ"
], - "tenderType": "ACCEPT_BY",
- "tenderExpiryDttm": "2024-02-27T15:00:00",
- "tenderExpiryTz": "GMT"
}
null
This API is used to accept tendered stops/routes by carrier. Stop/routes will be assigned to carrier once tender is accepted by carrier.
carrierCompanyCode required | string <= 50 characters nuDeliverit company code |
tenderRequest
object (TenderStopRequest) | |
object (TenderRouteRequest) | |
comments | string <= 200 characters Comments for accepting/rejecting/recalling tender stop/route. |
reasonCode | string <= 50 characters Reason code for rejecting or recalling tender stop/route. |
{- "stops": {
- "stopIds": [
- "abcd123340777",
- "abcd123340999"
], - "stopNbrs": [
- "STOP0001",
- "STOP0002"
]
}, - "comments": "Tender accepted"
}
null
This API is used to reject tendered stops/routes by carrier. When carrier rejects tendered stop/route, it will be auto tendered to next carrier from tendered list of carriers. If tendered carrier list is empty, stop/route will be auto rejected.
carrierCompanyCode required | string <= 50 characters nuDeliverit company code |
tenderRequest
object (TenderStopRequest) | |
object (TenderRouteRequest) | |
comments | string <= 200 characters Comments for accepting/rejecting/recalling tender stop/route. |
reasonCode | string <= 50 characters Reason code for rejecting or recalling tender stop/route. |
{- "stops": {
- "stopIds": [
- "abcd123340777",
- "abcd123340999"
], - "stopNbrs": [
- "STOP0001",
- "STOP0002"
]
}, - "comments": "Tender rejected",
- "reasonCode": "RS1"
}
null
This API is used to recall tendered stops/routes by shipper.
companyCode required | string <= 50 characters nuDeliverit company code |
tenderRequest
object (TenderStopRequest) | |
object (TenderRouteRequest) | |
comments | string <= 200 characters Comments for accepting/rejecting/recalling tender stop/route. |
reasonCode | string <= 50 characters Reason code for rejecting or recalling tender stop/route. |
{- "stops": {
- "stopIds": [
- "abcd123340777",
- "abcd123340999"
], - "stopNbrs": [
- "STOP0001",
- "STOP0002"
]
}, - "comments": "Tender recalled",
- "reasonCode": "RS1"
}
null
Get list of common inita data
companyCode required | string Company code for which init data is being fetched |
sourceType required | string Source Type where init data is required |
{- "serviceLevels": [
- {
- "value": "EXPRESS",
- "text": "EXPRESS"
}
], - "vehicleTypes": [
- {
- "value": "Truck",
- "text": "Truck"
}, - {
- "value": "Truck",
- "text": "MiniVan"
}
], - "zones": [
- {
- "value": "ATLANTA",
- "text": "ATLANTA"
}, - {
- "value": "TEXAS",
- "text": "TEXAS"
}
], - "accessorials": [
- {
- "value": "ACC",
- "text": "ACC"
}, - {
- "value": "IGP",
- "text": "IGP"
}
], - "revenueGLCodes": [
- {
- "value": "RVCODE",
- "text": "RVCOCE"
}
], - "expenseGLCodes": [
- {
- "value": "EXCODE",
- "text": "EXCOCE"
}
]
}