AC Nova REST API Reference for Clients
- Thomas.Bunge (Unlicensed)
- Javier.Marroquin
URLs
Production: https://nova-api.sekologistics.io
QA: https://nova-apiqa.sekologistics.io
Authentication
All API endpoints (except POST /api/user-tokens) must have the authorization header with a valid API token. API tokens can be obtained by POST /api/user-tokens or is supplied by system administrators.
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...Content Negotiation
All request bodies must be in JSON, and most response bodies are in JSON.
Content-Type: application/jsonUser Tokens
If the user has the user name and the password, below is how to obtain an API token.
POST /api/user-tokensRequest Example (application/json)
Response Example (application/json)
MAWBS
The user can get MAWB data or create a new MAWB with manifest
POST Request Example (application/json)
Name | Data Type | Description | Required |
|---|---|---|---|
BillToCode | string | Organization or branch code for Bill-to | YES |
BranchCode | string | Organization or branch code for Branch | YES |
ConsolidatorCode | string | Organization or branch code for Consolidator | YES |
DestinationCode | string | Organization or branch code for Destination | YES |
MawbNumber | string (format: 123-12345678) |
| YES |
OriginCode | string | Organization or branch code for Shipper | YES |
ShipperCode | string | Organization or branch code for Shipper | YES |
|
|
|
|
OriginPort | string (ex. ORD) | 3-letter IATA airport code for origin | YES |
DestinationPort | string (ex. JFK) | 3-letter IATA airport code for destination | YES |
ClientNotes | string (max 200) |
| NO |
Flights[].Eta | string (ISO Date) | ETA (local time) | YES |
Flights[].Etd | string (ISO Date) | ETD (local time) | YES |
Flights[].Number | string (ex. UA123) | 2-letter IATA airline code and flight number |
|
Manifests[].Data | string (Base 64 encoded data) | Data must be a .csv file or .xlsx file used for uploading to AC NOVA website | YES |
|
|
|
|
POST Response Example (application/json)
Manifest
The user can add a manifest to an existing MAWB using the created MawbNumber
Example
POST Request Example (application/json)
Name | Data Type | Description | Required |
|---|---|---|---|
Data | string (Base 64 encoded data) | Data must be a .csv file or .xlsx file used for uploading to AC NOVA website | YES |
POST Response Example (application/json)