nuVizz API (7.0)

Download OpenAPI specification:Download

Change Log

API Change Log

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

Terminology

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

Customer Order API

Multi-Leg Order API provides creation on single or multiple legs of transportation from PickUp to Delivery cross-docking through multiple-hubs.

Customer Order information

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.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the Stop belongs to

query Parameters
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.

Responses

Request samples

// 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();
  }
}
}

Response samples

Content type
application/json
{
  • "order": {
    }
}

Customer Order import

Import a Single Order

Authorizations:
BasicAuthentication
path Parameters
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

Request Body schema: application/json

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 xDockType=MULTILEG. A more elaborate description of legs of shipment

action
string <= 10 characters

action on top of a order creation

  • ACCEPT Accept the order (Creates the Legs for a order)

Responses

Request samples

Content type
application/json
Example
{
  • "order": {
    }
}

Response samples

Content type
application/json
{
  • "status": "Success"
}

Customer Order import (Synchronous)

Import a Single Order

Authorizations:
BasicAuthentication
path Parameters
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

Request Body schema: application/json

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 xDockType=MULTILEG. A more elaborate description of legs of shipment

action
string <= 10 characters

action on top of a order creation

  • ACCEPT Accept the order (Creates the Legs for a order)

Responses

Request samples

Content type
application/json
Example
{
  • "order": {
    }
}

Response samples

Content type
application/json
{
  • "order": {
    }
}

Customer Order Accept

Accept a Single Order

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code the order belongs

Request Body schema: application/json

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.

Responses

Request samples

Content type
application/json
{
  • "orderNbr": "Order039",
  • "orderId": "1234567abcdef"
}

Response samples

Content type
application/json
{
  • "order": {
    }
}

Cancel Customer Order (Synchronous)

Delete/Reject a stop(in unplanned, created statuses)

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the Stop/Order belongs to

Request Body schema: application/json
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.

Responses

Request samples

Content type
application/json
{
  • "orderNbr": "S10001112",
  • "orderId": "S10001112",
  • "reasonCode": "01",
  • "reasonComments": "In-valid Order details"
}

Response samples

Content type
application/json
{
  • "reasons": [
    ]
}

Delete Customer Order

Delete an order(in created statuses)

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the Order belongs to

Request Body schema: application/json
orderIds
Array of strings <= 50 items

List of orderIds

reason
required
string <= 250 characters

Mention the reason for deletion

Responses

Request samples

Content type
application/json
{
  • "orderIds": [
    ],
  • "reason": "string"
}

Response samples

Content type
application/json
{
  • "reasons": [
    ]
}

Reject Customer Order

Reject an order(in created statuses)

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the Order belongs to

Request Body schema: application/json
orderIds
Array of strings <= 50 items

List of orderIds

reason
required
string <= 250 characters

Mention the reason for reject

Responses

Request samples

Content type
application/json
{
  • "orderIds": [
    ],
  • "reason": "string"
}

Response samples

Content type
application/json
{
  • "reasons": [
    ]
}

Auth API

These APIs provide authorization info required to execute webservices.

Authorization Token to execute Webservice APIs.

This API provides Auth Token to execute webservice calls.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company

Responses

Response samples

Content type
application/json
{
  • "authToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5",
  • "expiresAt": 169560112,
  • "reasons": [
    ]
}

Public certificate for API auth token.

This API provides the certificate used by the auth Token to execute webservice calls.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company

Responses

Response samples

Content type
application/json
{
  • "cert": "MIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQCKAIc+hqdKgcPb9XbR5Osbdeq1J14zxRG58CkrHZO0PMSf/smoCEyEcxhGsjrITl/sLv/q8iOVMKgYKdpOMIoPDGCF8KCXA4F9hM/WXJstprEeqPi7a1FnXzi3uwaf+jy2zUviDt09jm+guu5TaZzTuzyoClEgfwIu2LwuHaJKtjceRKHWKvUqqxBQMXlq/s5lNXWajWSpLffP",
  • "reasons": [
    ]
}

Order-Stop Billing

These APIs provide for Stop/Order billing information. These include

  • Estimation
  • Final Charges

Get Stop Estimate

Determine the estimation of transportation cost for a stop. This operation does not create a stop

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the Stop belongs to

Request Body schema: application/json

Stop to be estimated

required
object (Stop)

Responses

Request samples

Content type
application/json
{
  • "stop": {
    }
}

Response samples

Content type
application/json
{
  • "estimate": {
    }
}

Create Stop Estimates

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.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the Stop belongs to

Request Body schema: application/json

Stops to be estimated

Array of objects (List of StopIds) <= 100 items

Responses

Request samples

Content type
application/json
{
  • "stops": [
    ]
}

Response samples

Content type
application/json
null

Get Billing Amts

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

  1. stopId - First preference
  2. stopNbr - 2nd Preference Atleast one of the query params are required
Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the Stop belongs to

query Parameters
stopId
string <= 50 characters

StopId of the stop being inquired

stopNbr
string <= 100 characters

StopNbr of the stop being inquired

Responses

Response samples

Content type
application/json
{
  • "billStatus": 50,
  • "estimate": {
    },
  • "billed": {
    }
}

Get Order Estimate

This API is used to estimate transportation cost for order. This does not create an order.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company code to which order belongs to

Request Body schema: application/json

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 xDockType=MULTILEG. A more elaborate description of legs of shipment

Responses

Request samples

Content type
application/json
{
  • "order": {
    },
  • "legs": [
    ]
}

Response samples

Content type
application/json
Example
{
  • "charges": [
    ],
  • "summary": {
    }
}

Create Order Estimate

  • Create order estimate charge entry If the order is not completed

  • Create final charge entry if the order is completed.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company code to which order belong to

Request Body schema: application/json

Orders to be estimated

Array of objects (List of orders) <= 100 items

Responses

Request samples

Content type
application/json
{
  • "orders": [
    ]
}

Response samples

Content type
application/json
null

Find Matching Contract

This API is used to get contract information

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string

Company Code of contract

Request Body schema: application/json
level
required
string <= 10 characters

Allowed values are STOP,MISC

object (MiscInfo)

Information which is used to generate non-transportation charges

object (Stop)

Responses

Request samples

Content type
application/json
Example
{
  • "level": "STOP",
  • "stop": {
    }
}

Response samples

Content type
application/json
{
  • "contract": {
    }
}

Doc Map API

Mapping Doc data to Stop

Import from Doc

Create stop from Doc

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the Stop belongs to

query Parameters
templateName
string <= 100 characters

Name of the Doc Mapping template to be used

Request Body schema: multipart/form-data
filename
string <binary>

Responses

Response samples

Content type
application/json
{
  • "stop": {
    },
  • "reasons": [
    ]
}

Vendor Master API

Create Or Update

Create/Update Vendor Master

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the Vendor belongs to

Request Body schema: application/json

Create Or Update Vendor Master

companyCode
required
string <= 50 characters

CompanyCode to which the Vendor belongs

required
Array of objects (Vendors) <= 100 items

Responses

Request samples

Content type
application/json
{
  • "companyCode": "001Test",
  • "vendors": [
    ]
}

Response samples

Content type
application/json
{
  • "reasons": [
    ]
}

List of Vendors

List of Vendors with Pagination

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the Vendor belongs to

Request Body schema: application/json

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

Responses

Request samples

Content type
application/json
{
  • "listReq": {
    },
  • "accountNumber": "ACC01",
  • "name": "john"
}

Response samples

Content type
application/json
{
  • "totalRecords": 81,
  • "defaultSize": 20,
  • "currentPageSize": 1,
  • "pageNo": 5,
  • "vendors": [
    ]
}

Vendor Information

If Account Number exists for the Vendor, it will return Vendor Info

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the Vendor belongs to

query Parameters
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.

Responses

Response samples

Content type
application/json
{
  • "vendor": {
    }
}

Events API

Event Information

Return the event information for entity provided.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code which the entity belongs to.

query Parameters
entityType
required
string <= 50 characters

Entity for which the event details are required.

  • STOP - Stop Event Data
  • ORDER - Order Event Data
entityId
required
string <= 50 characters

Unique alpha numeric system generated id used to refer a entity.

Responses

Response samples

Content type
application/json
{
  • "events": [
    ],
  • "reasons": [
    ]
}

Load API

Load Information

If the Load ID exists then it will return the load info along with events.

Authorizations:
BasicAuthentication
path Parameters
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

Responses

Request samples

// 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();
    }
  }
}

Response samples

Content type
application/json
{
  • "Load": {
    }
}

Static Route Information

If the Static Route loadNbr/loadId exists then it will return the Static Route info.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company code to which the Static Route belongs

query Parameters
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.

Responses

Response samples

Content type
application/json
{
  • "Load": {
    }
}

Load import

Imports the load in asynchronous mode.

Authorizations:
BasicAuthentication
path Parameters
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

Request Body schema: application/json

importRequest

companyCode
required
string <= 20 characters

CompanyCode from application

required
Array of objects (Loads) <= 500 items

Responses

Request samples

Content type
application/json
Example
{
  • "companyCode": "XYZ",
  • "loads": [
    ]
}

Response samples

Content type
application/json
{
  • "status": "Success"
}

Static Route Import

Imports the Static Route in synchronous mode.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code to which the Static Route belongs to

Request Body schema: application/json

importRequest

companyCode
required
string <= 20 characters

CompanyCode from application

required
Array of objects (StaticRoutes) <= 500 items

Responses

Request samples

Content type
application/json
{
  • "companyCode": "1181",
  • "loads": [
    ]
}

Response samples

Content type
application/json
{
  • "status": "Success",
  • "apiResult": {
    },
  • "reasons": [
    ]
}

Recurring Route Import

Creates a recurring route from an existing route in the system in synchronous mode.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code to which the route belongs

Request Body schema: application/json

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

  • M Monday
  • T Tuesday
  • W Wednesday
  • R Thursday
  • F Friday
  • S Saturday
  • U Sunday
overrideExisting
required
boolean

Override an existing recurring route of the same name

Responses

Request samples

Content type
application/json
{
  • "companyCode": "1181",
  • "routeNbr": "W59-NUDEL012944",
  • "routeName": "W-59MONDAY",
  • "daysOfWeek": "MW",
  • "overrideExisting": true
}

Response samples

Content type
application/json
{
  • "reasons": [
    ]
}

Assign Load to a Carrier

Assign a Load to a Carrier/Bussiness Partner by specifying the CarrierCode of the carrier.

Authorizations:
BasicAuthentication
path Parameters
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

Request Body schema: application/json

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.

Responses

Request samples

Content type
application/json
{
  • "carrierCode": "XYZBP",
  • "assignmentCriteria": "01"
}

Response samples

Content type
application/json
{
  • "status": "Success"
}

Unassign Load from a carrier

Unassign a Load from the Carrier/BusinessPartner

Authorizations:
BasicAuthentication
path Parameters
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

Request Body schema: application/json

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.

Responses

Request samples

Content type
application/json
{
  • "carrierCode": "XYZBP",
  • "assignmentCriteria": "01"
}

Response samples

Content type
application/json
{
  • "status": "Success"
}

Assign Load to a Driver

Assign a Load to a driver

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code of Load/Route

query Parameters
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.

Responses

Response samples

Content type
application/json
{
  • "reasons": [
    ]
}

Unassign Load to a Driver

Unassigning a a Load from a Driver

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code of Load/Route

query Parameters
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.

Responses

Response samples

Content type
application/json
{
  • "reasons": [
    ]
}

Cancel Load

Delete/Reject a Load that is unassigned from a Driver and move it to cancelled status

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code of Load/Route

Request Body schema: application/json
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.

Responses

Request samples

Content type
application/json
{
  • "loadNbr": "L1230001",
  • "loadId": "234544sadec0000000a23451",
  • "reasonCode": "01",
  • "reasonComments": "Duplicated orders on this Load"
}

Response samples

Content type
application/json
{
  • "reasons": [
    ]
}

Stop API

Stop Information

Details of a Stop/Order which is usually the product name, quantity, capacity constraints etc.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code of Stop

stopNbr
required
string <= 100 characters

Unique alpha numeric value used to refer a Stop/Order

Responses

Request samples

// 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();
        }
       }
      }

Response samples

Content type
application/json
{
  • "Stop": {
    }
}

Stop Info By Id

Details of a Stop/Order which is usually the product name, quantity, capacity constraints etc.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code which the Stop/Order belongs to.

query Parameters
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"]

Responses

Response samples

Content type
application/json
{
  • "stop": {
    },
  • "reasons": [
    ]
}

Stop Info By ShipmentNbr

List of Stop/Order which is usually the product name, quantity, capacity constraints etc.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code which the shipment belongs to.

query Parameters
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 yyyy-MM-ddTHH:mm:ss.

toDTTM
required
string <= 22 characters

Earliest Scheduled date and time in local format yyyy-MM-ddTHH:mm:ss.

Responses

Response samples

Content type
application/json
{
  • "stops": [
    ],
  • "reasons": [
    ]
}

PU & DO ETA Information

Return the pickup and delivery ETA Details of Stop/Order.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code which the Stop/Order belongs to.

query Parameters
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.

Responses

Response samples

Content type
application/json
{
  • "pickupETA": [
    ],
  • "deliveryETA": [
    ]
}

ETA Information

Return the ETA Details of Stop/Order.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code which the Stop/Order belongs to.

query Parameters
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.

Responses

Response samples

Content type
application/json
{
  • "etaDTTM": "2023-07-24T07:19:00",
  • "earliestEtaDTTM": "2023-07-24T07:49:00",
  • "latestEtaDTTM": "2023-07-24T08:19:00",
  • "etaWindow": 30
}

Event Information

Return the event information of Stop/Order.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code which the Stop/Order belongs to.

query Parameters
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.

Responses

Response samples

Content type
application/json
{
  • "events": [
    ]
}

Stop import

Import a Stop/Order for a certain Company

Authorizations:
BasicAuthentication
path Parameters
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

Request Body schema: application/json

importRequest

companyCode
required
string <= 20 characters

Company Code of Stop.

required
Array of objects (Stops) <= 500 items

Responses

Request samples

Content type
application/json
{
  • "companyCode": "XYZ,",
  • "stops": [
    ]
}

Response samples

Content type
application/json
{
  • "status": "Success"
}

Stop import (Synchronous)

Import a Stop/Order for a certain Company

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code of Stop

Request Body schema: application/json

importRequest

companyCode
required
string <= 20 characters

Company Code of Stop.

required
object (Stop)

Responses

Request samples

Content type
application/json
{
  • "companyCode": "XYZ,",
  • "stop": {
    }
}

Response samples

Content type
application/json
{
  • "status": "Success",
  • "apiResult": {
    },
  • "reasons": [
    ]
}

Assign Stop to a Carrier

Assign a Stop to a Business Partner/Carrier using Carrier Code

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code of Stop

stopNbr
required
string <= 100 characters

Unique alpha numeric value that refers to a Stop/Order

Request Body schema: application/json

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.

Responses

Request samples

Content type
application/json
{
  • "carrierCode": "XYZBP",
  • "assignmentCriteria": "01"
}

Response samples

Content type
application/json
{
  • "status": "Success"
}

Assign Stop to a Business Partner/Carrier

Assign a Stop to a Business Partner/Carrier using Carrier Code

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code of Stop

Request Body schema: application/json

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.

Responses

Request samples

Content type
application/json
{
  • "stopNbr": "S10001112",
  • "stopId": "string",
  • "bpId": 12345,
  • "carrierCode": "XYZBP",
  • "assignmentCriteria": "01"
}

Response samples

Content type
application/json
{
  • "status": "Success"
}

Unassign Stop to a carrier

Unassign a Stop from a Carrier/Business Partner(Previously assigned to a Carrier)

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code of Stop

Request Body schema: application/json

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.

Responses

Request samples

Content type
application/json
{
  • "stopNbr": "S10001112",
  • "stopId": "string"
}

Response samples

Content type
application/json
{
  • "status": "Success"
}

Cancel Stop

Delete/Reject a stop(in unplanned, created statuses)

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code of Stop

Request Body schema: application/json
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.

Responses

Request samples

Content type
application/json
{
  • "stopNbr": "S10001112",
  • "stopId": "S10001112",
  • "reasonCode": "01",
  • "reasonComments": "In-valid Stop details"
}

Response samples

Content type
application/json
{
  • "status": "Success"
}

ASN API

ASN import

Import a advanced shipment notice (ASN)

Authorizations:
BasicAuthentication
path Parameters
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

Request Body schema: application/json

importRequest

companyCode
required
string <= 20 characters

Company Code of Stop.

required
Array of objects (Stops) <= 500 items

Responses

Request samples

Content type
application/json
{
  • "companyCode": "XYZ",
  • "stops": [
    ]
}

Response samples

Content type
application/json
{
  • "status": "Success"
}

Cancel ASN

Delete/Reject a ASN(InboundShipment status)

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code of Stop

Request Body schema: application/json
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.

Responses

Request samples

Content type
application/json
{
  • "stopNbr": "S10001112",
  • "stopId": "S10001112",
  • "reasonCode": "01",
  • "reasonComments": "In-valid Stop details"
}

Response samples

Content type
application/json
{
  • "status": "Success"
}

Stop Template API

Stop Template Information

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.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code of StopTemplate

query Parameters
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.

Responses

Response samples

Content type
application/json
{
  • "stopTemplates": [
    ]
}

Stop Template Information with Pagination

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.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code of StopTemplate

Request Body schema: application/json
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.

Responses

Request samples

Content type
application/json
{
  • "pageSize": 20,
  • "page": 1,
  • "maxResult": 20
}

Response samples

Content type
application/json
{
  • "totalRecords": 81,
  • "defaultSize": 20,
  • "currentPageSize": 1,
  • "pageNo": 5,
  • "stopTemplates": [
    ]
}

Stop Template import

Import a Stop Template for a certain Company

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code of Stop Template

Request Body schema: application/json

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

Responses

Request samples

Content type
application/json
{
  • "id": "abcdefabcdef0002020",
  • "companyCode": "ABC",
  • "name": "templateName",
  • "recurs": {
    },
  • "stopTemplate": {
    }
}

Response samples

Content type
application/json
{
  • "status": "Success"
}

Cancel Stop Template

Cancel a stopTemplate

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code of StopTemplate

query Parameters
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

Responses

Response samples

Content type
application/json
{
  • "status": "Success"
}

Business Partner API

Create or update business partner

Create or Update business partner

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code for which Business Partner is created

Request Body schema: application/json
companyCode
required
string <= 20 characters

CompanyCode to which the Business parter belongs

required
Array of objects (BusinessPartners) <= 20 items

Responses

Request samples

Content type
application/json
Example
{
  • "companyCode": "XYZ",
  • "businessPartners": [
    ]
}

Response samples

Content type
application/json
{
  • "status": "Success"
}

Associate Customers to Business Partner

Associate Customers to Business Partner

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code for which Business Partner is created

query Parameters
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.

Request Body schema: application/json
accountNumbers
required
Array of strings <= 500 items [ items <= 20 characters ]

List of Customer Account Numbers.

Responses

Request samples

Content type
application/json
{
  • "accountNumbers": [
    ]
}

Response samples

Content type
application/json
{
  • "reasons": [
    ]
}

Business Partner Customer information

Business Partner Customer information

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Company Code for which Business Partner is created

query Parameters
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.

Responses

Response samples

Content type
application/json
{
  • "bpId": "string",
  • "customers": [
    ]
}

User API

Create Users

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
Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

CompanyCode to which the user belongs

Request Body schema: application/json
companyCode
required
string <= 20 characters

CompanyCode to which the User belongs

required
Array of objects (Users) <= 500 items

Responses

Request samples

Content type
application/json
Example
{
  • "companyCode": "001Test",
  • "users": [
    ]
}

Response samples

Content type
application/json
{
  • "status": "Success",
  • "apiResult": {
    },
  • "reasons": [
    ]
}

Create User (Synchronous)

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
Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

CompanyCode to which the user belongs

Request Body schema: application/json
companyCode
required
string <= 20 characters

CompanyCode to which the User belongs

required
Array of objects (Users) <= 500 items

Responses

Request samples

Content type
application/json
Example
{
  • "companyCode": "001Test",
  • "users": [
    ]
}

Response samples

Content type
application/json
null

Create User With Docs

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
Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

CompanyCode to which the user belongs

Request Body schema: multipart/form-data
required
object (User)
profPic
string <binary>

profile image

vehPic
string <binary>

vehicle image

documents
Array of strings <binary>

user document images

Responses

Request samples

Content type
multipart/form-data
{
  "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"
}

Response samples

Content type
application/json
null

Update user documents

With the User API, partners will be able to update/modify the user documents.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

CompanyCode to which the user belongs

Request Body schema: multipart/form-data
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
  • PROF_PIC - Profile picture
  • VEH_PIC - Vehicle picture
  • USER_DOCS - User documents
documents
Array of strings <binary>

user document images

Responses

Request samples

Content type
multipart/form-data
Example
{
  "userId": 1234,
  "imageType": "PROF_PIC",
  "documents": "array of multipart data of the all the user related documents"
}

Response samples

Content type
application/json
null

User List

With the User API, partners will be retreive a list of users on the system. operationId: userList

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

CompanyCode to which the user belongs

Request Body schema: application/json
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)

Responses

Request samples

Content type
application/json
{
  • "customerRefId": "abcdef123456",
  • "pageInfo": {
    },
  • "searchCriteria": {
    }
}

Response samples

Content type
application/json
{
  • "totalRecords": 81,
  • "defaultSize": 20,
  • "currentPageSize": 1,
  • "pageNo": 5,
  • "users": [
    ]
}

User Profile

Partners will retreive the profile of a user on the system. operationId: userInfo

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

CompanyCode to which the user belongs

query Parameters
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.

Responses

Request samples

// 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();
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "userId": 1234,
  • "title": "string",
  • "firstName": "Test",
  • "lastName": "Bond",
  • "userName": "TestUser",
  • "email": "dr1231@nuvizz.com",
  • "middleName": "Neo",
  • "allowedFacilities": [
    ],
  • "defaultFacility": "FAC-1",
  • "allowAllFacilites": false,
  • "defaultCompany": "string",
  • "allowedCompanies": [
    ],
  • "companys": [
    ],
  • "allowAllCompanies": false,
  • "password": "********",
  • "gender": "Male",
  • "dob": "2001-12-31",
  • "age": 29,
  • "accountStatus": "string",
  • "customerRefId": "abcdef123456",
  • "vendorId": "abcdef123456",
  • "vehicle": {
    },
  • "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": [
    ],
  • "certificationAndSkills": [
    ],
  • "assignmentType": 1,
  • "unableToUseApp": true,
  • "licenseAuthority": "DMV",
  • "licenseExpirationDttm": "2001-12-31",
  • "licenseState": "Georgia",
  • "mobileNumber": 4048621577,
  • "userKey": "Client assign key",
  • "profilePicPath": "document/COMPCODE/43221",
  • "documents": [
    ],
  • "documentInfos": [
    ],
  • "userRoles": [
    ],
  • "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": [
    ],
  • "widgetName": "string",
  • "allowChildCompAccess": false,
  • "allowBPAccess": false,
  • "allowedDomains": [
    ],
  • "allowedIPAddresses": [
    ],
  • "assignedGroups": "memberadmin",
  • "enabled": true,
  • "phoneNumber": 4048621577,
  • "smsNumber": 4048621577,
  • "profilePic": "Base64 png image"
}

Enable/Disable User

This request will update the status of the User operationId: updateStatus

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

CompanyCode to which the user belongs

Request Body schema: application/json

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

Responses

Request samples

Content type
application/json
{
  • "id": "string",
  • "userName": "string",
  • "enabled": true
}

Response samples

Content type
application/json
{
  • "status": "Success"
}

Note API

Add

Add customer note

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the Customer belongs to

Request Body schema: application/json

Add Notes

entity
required
string <= 50 characters

Entity Type of the Object CUSTOMER USER

entityCode
string <= 20 characters

Unique alpha numeric value used to refer a Entity. like Account number for customer User name for User

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)

Responses

Request samples

Content type
application/json
{
  • "entity": "ACC01",
  • "entityCode": "ACC01",
  • "entityRef": "abcdd123",
  • "note": {
    }
}

Response samples

Content type
application/json
null

List

Notes List

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the Notes belongs to

query Parameters
entity
required
string <= 50 characters

Entity Type of the Object CUSTOMER USER

entityCode
string <= 50 characters

Unique alpha numeric value used to refer a Entity. like Account number for customer User name for User

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.

Request Body schema: application/json

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

Responses

Request samples

Content type
application/json
{
  • "listReq": {
    },
  • "refType": "CUSTOMER",
  • "tag": "memo",
  • "addedOn": "1d",
  • "addedBy": "admin"
}

Response samples

Content type
application/json
{
  • "totalRecords": 81,
  • "defaultSize": 20,
  • "currentPageSize": 1,
  • "pageNo": 5,
  • "notes": [
    ]
}

Route Plan API

Create or Update Route Plan

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 or un-planned

Authorizations:
BasicAuthentication
path Parameters
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 Route belongs to

Request Body schema: application/json
companyCode
required
string <= 50 characters

CompanyCode from application

required
object (Route)

Responses

Request samples

Content type
application/json
Example
{
  • "companyCode": "XYZ",
  • "route": {
    }
}

Response samples

Content type
application/json
{
  • "status": "Success"
}

Appointment

Get available appointment

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.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the appointment slots belongs to

Request Body schema: application/json

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)

Responses

Request samples

Content type
application/json
{
  • "stopNbr": "ORDER0001",
  • "stopId": "abcd123340707",
  • "apptStartDate": "2023-09-25",
  • "stopInfo": {
    }
}

Response samples

Content type
application/json
{
  • "stopNbr": "ORDER0001",
  • "stopId": "abcd123340707",
  • "stopInfo": {
    },
  • "serviceRegion": "eastzone",
  • "apptSlots": [
    ]
}

Set appointment

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

  1. stopId - First preference
  2. stopInfo - Second preference

RequestBody can be provided for the following groups and Atleast one of the field is required

  1. timeslotId
  2. apptId
Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the appointment slots belongs to

Request Body schema: application/json

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)

Responses

Request samples

Content type
application/json
{
  • "timeSlotId": "123",
  • "stopNbr": "ORDER0001",
  • "stopId": "abcd123340707",
  • "apptStartDate": "2023-09-25",
  • "stopInfo": {
    }
}

Response samples

Content type
application/json
{
  • "stopNbr": "ORDER0001",
  • "stopId": "abcd123340707",
  • "apptStatus": "ONHOLD",
  • "apptTTL": 15,
  • "apptId": "12345",
  • "serviceRegion": "eastzone",
  • "stopInfo": {
    }
}

Cancel appointment

This API cancels appointment for order. RequestBody can be provided for the following groups and Atleast one of the field is required

  1. stopIds - First preference
  2. stopNbrs - Second preference
Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the appointment belongs to

Request Body schema: application/json

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.

Responses

Request samples

Content type
application/json
{
  • "stopIds": [
    ],
  • "stopNbrs": [
    ],
  • "comment": "Not available"
}

Response samples

Content type
application/json
null

Trigger customer appointment schedule

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

  1. stopIds - First preference
  2. stopNbrs - Second preference
Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

NuDeliverIt Company code.

Request Body schema: application/json

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.

Responses

Request samples

Content type
application/json
{
  • "stopIds": [
    ],
  • "stopNbrs": [
    ]
}

Response samples

Content type
application/json
null

Deprecated Order API

Customer Order information

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.

Authorizations:
BasicAuthentication
path Parameters
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

Responses

Request samples

// 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();
  }
}
}

Response samples

Content type
application/json
{
  • "Order": [
    ]
}

Customer Order import

Import a Order for a certain nuDeliverItCompany

Authorizations:
BasicAuthentication
path Parameters
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

Request Body schema: application/json

importRequest

companyCode
required
string <= 20 characters

Code of a nudeliverit Company to which the Order belongs to.

required
Array of objects (Orders) <= 50 items

Responses

Request samples

Content type
application/json
Example
{
  • "companyCode": "XYZ",
  • "orders": [
    ]
}

Response samples

Content type
application/json
{
  • "status": "Success"
}

Cancel Customer Order

Delete/Reject a stop(in unplanned, created statuses)

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the Stop/Order belongs to

Request Body schema: application/json
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.

Responses

Request samples

Content type
application/json
{
  • "orderNbr": "S10001112",
  • "reasonCode": "01",
  • "reasonComments": "In-valid Stop details"
}

Response samples

Content type
application/json
{
  • "status": "Success"
}

Customer API

Customer information

Customer API is used to create a request to retreive customer information. Customers represent the shipper who will be providing orders to the carriers.

Authorizations:
BasicAuthentication
path Parameters
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

Responses

Request samples

// 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();
  }
}
}

Response samples

Content type
application/json
{
  • "Customer": [
    ]
}

Customer import

Import a Customer for a certain nuDeliverItCompany

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the Customer belongs to

Request Body schema: application/json

importRequest

companyCode
required
string <= 20 characters

Code of a nudeliverit Company to which the Customer belongs to.

required
Array of objects (Customers) <= 500 items

Responses

Request samples

Content type
application/json
{
  • "companyCode": "XYZ",
  • "customers": [
    ]
}

Response samples

Content type
application/json
{
  • "status": "Success",
  • "apiResult": {
    },
  • "reasons": [
    ]
}

Customer import (Synchronous)

Import a Customer for a certain nuDeliverItCompany

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the Customer belongs to

Request Body schema: application/json

importRequest

companyCode
required
string <= 20 characters

CompanyCode to which the User belongs

required
object (Customer)

Responses

Request samples

Content type
application/json
{
  • "companyCode": "XYZ",
  • "customers": [
    ]
}

Response samples

Content type
application/json
{
  • "customer": {
    },
  • "apiResult": {
    },
  • "reasons": [
    ]
}

Customer Address List

List customer addresses for a certain nuDeliverItCompany

Authorizations:
BasicAuthentication
path Parameters
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

Request Body schema: application/json

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.

Responses

Request samples

Content type
application/json
{
  • "pageSize": 20,
  • "page": 1,
  • "maxResult": 20
}

Response samples

Content type
application/json
{
  • "totalRecords": 81,
  • "defaultSize": 20,
  • "currentPageSize": 1,
  • "pageNo": 5,
  • "addresses": [
    ]
}

Customer Address Update

Create or Update an address for a Customer for a certain nuDeliverItCompany

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the Customer belongs to

Request Body schema: application/json

APIRequest

accountNumber
required
string <= 20 characters

Unique alpha numeric value used to refer a Customer.

required
object (AddressDetail)

Responses

Request samples

Content type
application/json
{
  • "accountNumber": "ACC_123",
  • "customerAddress": {
    }
}

Response samples

Content type
application/json
null

Customer Address Removal

Remove an address for a Customer for a certain nuDeliverItCompany

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

Code of the nuDeliverIt Company to which the Customer belongs to

Request Body schema: application/json

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.

Responses

Request samples

Content type
application/json
{
  • "accountNumber": "ACC_123",
  • "label": "Primary"
}

Response samples

Content type
application/json
null

Demand API

Demand Import

Demand API is used to create a request to create/update a demand.

Authorizations:
BasicAuthentication
path Parameters
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 Demand belongs to

Request Body schema: application/json

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

Responses

Request samples

Content type
application/json
{
  • "companyCode": "XYZ",
  • "demandPool": "demandPool_001",
  • "demands": [
    ]
}

Response samples

Content type
application/json
{
  • "status": "Success"
}

Tender API

Tender issue

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.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

nuDeliverit company code

Request Body schema: application/json

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

  • ACCEPT_BY Accept tendered stops/routes within {tenderExpiryDttm}
  • REJECT_BY Reject tendered stops/routes within {tenderExpiryDttm}
tenderExpiryDttm
string <= 22 characters

Tender expiry date and time in yyyy-MM-ddTHH:mm:ss format.

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.

Responses

Request samples

Content type
application/json
Example
{
  • "stops": {
    },
  • "carrierCodes": [
    ],
  • "tenderType": "ACCEPT_BY",
  • "tenderExpiryDttm": "2024-02-27T15:00:00",
  • "tenderExpiryTz": "GMT"
}

Response samples

Content type
application/json
null

Tender accept

This API is used to accept tendered stops/routes by carrier. Stop/routes will be assigned to carrier once tender is accepted by carrier.

Authorizations:
BasicAuthentication
path Parameters
carrierCompanyCode
required
string <= 50 characters

nuDeliverit company code

Request Body schema: application/json

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.

Responses

Request samples

Content type
application/json
Example
{
  • "stops": {
    },
  • "comments": "Tender accepted"
}

Response samples

Content type
application/json
null

Tender reject

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.

Authorizations:
BasicAuthentication
path Parameters
carrierCompanyCode
required
string <= 50 characters

nuDeliverit company code

Request Body schema: application/json

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.

Responses

Request samples

Content type
application/json
Example
{
  • "stops": {
    },
  • "comments": "Tender rejected",
  • "reasonCode": "RS1"
}

Response samples

Content type
application/json
null

Tender recall

This API is used to recall tendered stops/routes by shipper.

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string <= 50 characters

nuDeliverit company code

Request Body schema: application/json

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.

Responses

Request samples

Content type
application/json
Example
{
  • "stops": {
    },
  • "comments": "Tender recalled",
  • "reasonCode": "RS1"
}

Response samples

Content type
application/json
null

Common Init API

API to get common init data

Get list of common inita data

Authorizations:
BasicAuthentication
path Parameters
companyCode
required
string

Company code for which init data is being fetched

query Parameters
sourceType
required
string

Source Type where init data is required

Responses

Response samples

Content type
application/json
{
  • "serviceLevels": [
    ],
  • "vehicleTypes": [
    ],
  • "zones": [
    ],
  • "accessorials": [
    ],
  • "revenueGLCodes": [
    ],
  • "expenseGLCodes": [
    ]
}