Submits and updates purchase orders in DSV's Supply Chain Management (eDC) platform, the order-management layer that sits above the forwarding products. Order and shipment records carry carrier SCAC codes, master and house bill of lading numbers and container numbers.
{
"openapi": "3.0.1",
"info": {
"title": "Orders - SCM",
"description": "test - Submit purchase orders to SCM and request updates via the Orders API\\n",
"version": "v2"
},
"servers": [
{
"url": "https://api.dsv.com/om/v2"
}
],
"paths": {
"/Orders/id/{id}": {
"get": {
"tags": [
"Orders"
],
"summary": "6. Get order by guid/uuid.",
"description": "Get order by guid/uuid",
"operationId": "GETapi-public-v2-Orders-id-id",
"parameters": [
{
"name": "id",
"in": "path",
"description": "Format - uuid.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Content-Type",
"in": "header",
"required": true,
"schema": {
"enum": [
"application/json"
],
"type": "string"
}
},
{
"name": "Accept",
"in": "header",
"required": true,
"schema": {
"enum": [
"application/json"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/eDC.Web.Api.v2.Models.OrderDto"
}
}
}
}
}
}
}
},
"/Orders/{orderNumber}/{splitNo}": {
"get": {
"tags": [
"Orders"
],
"summary": "5. Get order by order number and split number",
"description": "Get order by order number and split number",
"operationId": "GETapi-public-v2-Orders-orderNumber-splitNo",
"parameters": [
{
"name": "orderNumber",
"in": "path",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "splitNo",
"in": "path",
"description": "Format - int64.",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "Authorization",
"in": "header",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Content-Type",
"in": "header",
"required": true,
"schema": {
"enum": [
"application/json"
],
"type": "string"
}
},
{
"name": "Accept",
"in": "header",
"required": true,
"schema": {
"enum": [
"application/json"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/eDC.Web.Api.v2.Models.OrderDto"
}
}
}
}
}
}
},
"delete": {
"tags": [
"Orders"
],
"summary": "7. Delete order by order number and split number",
"description": "Delete order by order number and split number",
"operationId": "DELETEapi-public-v2-Orders-orderNumber-splitNo",
"parameters": [
{
"name": "orderNumber",
"in": "path",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "splitNo",
"in": "path",
"description": "Format - int64.",
"required": true,
"schema": {
"type": "integer"
}
}
],
"responses": {
"200": {
"description": "Success"
}
}
}
},
"/Orders/{orderNumber}": {
"get": {
"tags": [
"Orders"
],
"summary": "4. Get orders by order number",
"description": "Get orders by order number",
"operationId": "GETapi-public-v2-Orders-orderNumber",
"parameters": [
{
"name": "orderNumber",
"in": "path",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Content-Type",
"in": "header",
"required": true,
"schema": {
"enum": [
"application/json"
],
"type": "string"
}
},
{
"name": "Accept",
"in": "header",
"required": true,
"schema": {
"enum": [
"application/json"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/eDC.Web.Api.v2.Models.OrderDto"
}
}
}
}
}
}
}
},
"/Orders": {
"post": {
"tags": [
"Orders"
],
"summary": "1. Create Order(s)",
"description": "Create Order(s)",
"operationId": "POSTapi-public-v2-Orders",
"parameters": [
{
"name": "Authorization",
"in": "header",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Content-Type",
"in": "header",
"required": true,
"schema": {
"enum": [
"application/json"
],
"type": "string"
}
},
{
"name": "Accept",
"in": "header",
"required": true,
"schema": {
"enum": [
"application/json"
],
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/eDC.Web.Api.v2.Models.OrderDto"
}
}
}
},
"responses": {
"200": {
"description": "Success"
}
}
}
},
"/Orders/SearchCriteria": {
"post": {
"tags": [
"Orders"
],
"summary": "3. Search for Orders by criteria",
"description": "Search for Orders by criteria",
"operationId": "POSTapi-public-v2-Orders-SearchCriteria",
"parameters": [
{
"name": "Authorization",
"in": "header",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Content-Type",
"in": "header",
"required": true,
"schema": {
"enum": [
"application/json"
],
"type": "string"
}
},
{
"name": "Accept",
"in": "header",
"required": true,
"schema": {
"enum": [
"application/json"
],
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/eDC.Web.Api.v2.Models.Search.SearchRequest"
},
"example": {
"grid": {
"Page": 0,
"PageSize": 0,
"Sorts": [
{
"Member": "string",
"SortDirection": "Ascending"
}
],
"Filters": [
{}
],
"Groups": [
{
"MemberType": "string",
"DisplayContent": {},
"AggregateFunctions": [
{
"AggregateMethodName": "string",
"Caption": "string",
"SourceField": "string",
"FunctionName": "string",
"MemberType": "string",
"ResultFormatString": "string"
}
],
"Member": "string",
"SortDirection": "Ascending"
}
],
"Aggregates": [
{
"Aggregates": [
{
"AggregateMethodName": "string",
"Caption": "string",
"SourceField": "string",
"FunctionName": "string",
"MemberType": "string",
"ResultFormatString": "string"
}
],
"Member": "string"
}
]
},
"criteria": "string"
}
}
}
},
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/eDC.Web.Api.v2.Models.OrderDto"
}
}
}
}
}
}
}
},
"/OrdersAsync": {
"post": {
"tags": [
"OrdersAsync"
],
"summary": "2. Post a collection of orders asynchronously",
"description": "Post a collection of orders asynchronously",
"operationId": "POSTapi-public-v2-OrdersAsync",
"parameters": [
{
"name": "Authorization",
"in": "header",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Content-Type",
"in": "header",
"required": true,
"schema": {
"enum": [
"application/json"
],
"type": "string"
}
},
{
"name": "Accept",
"in": "header",
"required": true,
"schema": {
"enum": [
"application/json"
],
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/eDC.Web.Api.v2.Models.OrderDto"
}
}
}
}
},
"responses": {
"200": {
"description": "Success"
}
}
}
},
"/api/public/v2/Orders/ProcessOrderEDI": {
"post": {
"tags": [
"Orders"
],
"summary": "8. ProcessOrderEDI",
"description": "ProcessOrderEDI",
"operationId": "POSTapi-public-v2-Orders-ProcessOrderEDI",
"parameters": [
{
"name": "Authorization",
"in": "header",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Content-Type",
"in": "header",
"required": true,
"schema": {
"enum": [
"application/json"
],
"type": "string"
}
},
{
"name": "Accept",
"in": "header",
"required": true,
"schema": {
"enum": [
"application/json"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Success"
}
}
}
}
},
"components": {
"schemas": {
"eDC.Domain.Enums.BookingConsolState": {
"enum": [
"Provisional",
"Confirmed"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.BookingEventCode": {
"enum": [
"ADD",
"PBK",
"CSR",
"OLC",
"SDC",
"BLN",
"BUD",
"PRV",
"BOK",
"APR",
"RJT",
"PRK",
"CNF",
"TRN",
"RTB",
"EVD",
"CPS",
"CAN",
"TCA",
"COD",
"SPD",
"USP",
"BCR",
"DTC",
"DLP",
"QA",
"EDC_CPA",
"FUP",
"BRA",
"CFU",
"FCIV",
"UCIV",
"ASN"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.BookingState": {
"enum": [
"Provisional",
"PreBooked",
"Rejected",
"Booked",
"Approved",
"Confirmed",
"Parked",
"Transmitted",
"PendingConsolidation",
"Planning",
"Planned",
"Consolidated",
"PendingCollection",
"Collected",
"OnHand",
"DepartedOriginCFS",
"Shipped",
"Arrived",
"CustomsCommenced",
"CustomsCleared",
"AvailableDestinationCFS",
"PendingDelivery",
"DepartedDestinationCFS",
"Handover",
"Delivered",
"Suspended",
"Cancelled"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.CargoReceiptState": {
"enum": [
"Pending",
"Received",
"Putaway",
"Loaded"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.CommercialInvoiceState": {
"enum": [
"Finalised",
"Unfinalised"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.ContactAlertContext": {
"enum": [
"None",
"Buyer",
"Supplier",
"Consignee",
"Consignor",
"ServiceProvider",
"PickupFrom",
"DeliverTo",
"Contractor"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.ContainerState": {
"enum": [
"Provisional",
"ReleasedCY",
"PickupBooked",
"PickedUp",
"GateIn",
"Loaded",
"Shipped",
"Arrived",
"Unloaded",
"DeliveryBooked",
"GateOut",
"Delivered",
"EmptyReadyForReturn",
"EmptyReturned"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.EventCodeModule": {
"enum": [
"Shipment",
"Booking",
"Order",
"OrderLine",
"LoadPlan",
"Container",
"Message"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.KpiStatus": {
"enum": [
"None",
"InProgress",
"CompletedOnSchedule",
"Due",
"OverDue"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.LoadPlanState": {
"enum": [
"Provisional",
"Submitted",
"Rejected",
"Approved",
"Confirmed",
"Accepted",
"Loaded",
"Declined",
"Cancelled"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.LoadPlanType": {
"enum": [
"PLAN",
"CONSOL"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.MeasurementSystem": {
"enum": [
"Metric",
"Imperial"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.ModuleType": {
"enum": [
"Order",
"Shipment",
"Booking",
"ShipmentContainer",
"ShipmentPackLine",
"ConsolContainer",
"OrderLine",
"BookingPackLine",
"EDI",
"OrderLineManager",
"Announcement",
"Document",
"Note",
"BookingContainer",
"OrderPackLine",
"LoadPlan",
"EventMilestone",
"Company",
"ExceptionPanelConfiguration",
"Unspecified"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.OrderEventCode": {
"enum": [
"ADD",
"ATS",
"DTS",
"CNF",
"UCF",
"ONH",
"EEX",
"OUD",
"FUP",
"CAI",
"QA",
"GR",
"CAN",
"UCA",
"UPD",
"ATB",
"DFB",
"CCI"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.OrderState": {
"enum": [
"Provisional",
"Open",
"Confirmed",
"OnHand",
"BookingProvisional",
"BookingPreBooked",
"BookingBooked",
"BookingRejected",
"BookingApproved",
"BookingConfirmed",
"BookingParked",
"PendingConsolidation",
"Planning",
"Planned",
"Consolidated",
"PendingCollection",
"Collected",
"BookingOnHand",
"DepartedOriginCFS",
"Shipped",
"Arrived",
"CustomsCommenced",
"CustomsCleared",
"AvailableDestinationCFS",
"PendingDelivery",
"DepartedDestinationCFS",
"Handover",
"Delivered",
"Fulfilled",
"Suspended",
"Cancelled"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.OrgProduct": {
"enum": [
"POVisibility",
"POControl",
"POManager",
"POCarrierAllocationManager",
"MultiLSPPOM",
"eDCLite",
"FreightManager"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.PackingStatus": {
"enum": [
"PND",
"DLV",
"CAN"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.PackingType": {
"enum": [
"Individual",
"Aggregated",
"ExportLoad"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.ShipmentState": {
"enum": [
"Booked",
"PendingConsolidation",
"Planning",
"Planned",
"Consolidated",
"Accepted",
"PendingCollection",
"Collected",
"OnHand",
"DepartedOriginCFS",
"Shipped",
"Arrived",
"CustomsCommenced",
"CustomsCleared",
"AvailableDestinationCFS",
"PendingDelivery",
"DepartedDestinationCFS",
"Handover",
"Delivered",
"Declined",
"Suspended",
"Cancelled"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.SplitMode": {
"enum": [
"None",
"Manual",
"Auto"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.SubscriptionType": {
"enum": [
"All",
"Include",
"Exclude"
],
"type": "string",
"format": "int32"
},
"eDC.Domain.Enums.TableCode3": {
"enum": [
"NON",
"ORD",
"ORI",
"OIC",
"BOK",
"BCS",
"SHP",
"CON",
"PTT",
"KDT",
"INV",
"PCK",
"ORG",
"SCN",
"JCN",
"CIH",
"CIL",
"EDM",
"ETL",
"ANN",
"DOC",
"NOT",
"BKC",
"PMD",
"ADN",
"PDG",
"CGR",
"LPL",
"OLM",
"PCT",
"BKT",
"JOI",
"EPC"
],
"type": "string",
"format": "int32"
},
"eDC.Web.Api.v2.Controllers.ChangeStateRequest": {
"type": "object",
"properties": {
"bookingNumber": {
"type": "string",
"description": "Booking Number",
"nullable": true
},
"state": {
"$ref": "#/components/schemas/eDC.Domain.Enums.BookingState"
},
"note": {
"type": "string",
"description": "Notes",
"nullable": true
},
"intendedParty": {
"type": "string",
"description": "Intended Party",
"nullable": true
}
},
"additionalProperties": false
},
"eDC.Web.Api.v2.Controllers.LoadPlanChangeStateRequest": {
"type": "object",
"properties": {
"loadPlanNumber": {
"type": "string",
"nullable": true
},
"state": {
"$ref": "#/components/schemas/eDC.Domain.Enums.LoadPlanState"
},
"note": {
"type": "string",
"nullable": true
},
"intendedParty": {
"type": "string",
"nullable": true
}
},
"additionalProperties": false
},
"eDC.Web.Api.v2.Controllers.ReduceStateRequest": {
"type": "object",
"properties": {
"bookingNumber": {
"type": "string",
"nullable": true
},
"state": {
"$ref": "#/components/schemas/eDC.Domain.Enums.BookingState"
}
},
"additionalProperties": false
},
"eDC.Web.Api.v2.Models.CustomField": {
"type": "object",
"properties": {
"name": {
"type": "string",
"nullable": true
},
"type": {
"type": "string",
"nullable": true
},
"value": {
"type": "string",
"nullable": true
}
},
"additionalProperties": false
},
"eDC.Web.Api.v2.Models.Entities.AdditionalReference": {
"type": "object",
"properties": {
"type": {
"type": "string",
"nullable": true
},
"description": {
"type": "string",
"nullable": true
},
"value": {
"type": "string",
"nullable": true
}
},
"additionalProperties": false
},
"eDC.Web.Api.v2.Models.Entities.Address": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name",
"nullable": true
},
"address1": {
"type": "string",
"description": "Address line 1",
"nullable": true
},
"address2": {
"type": "string",
"description": "Address line 2",
"nullable": true
},
"address3": {
"type": "string",
"description": "Address line 3",
"nullable": true
},
"unloco": {
"type": "string",
"nullable": true
},
"nearestPort": {
"type": "string",
"nullable": true
},
"city": {
"type": "string",
"description": "City",
"nullable": true
},
"state": {
"type": "string",
"description": "State",
"nullable": true
},
"postCode": {
"type": "string",
"description": "Postal code",
"nullable": true
},
"countryCode": {
"type": "string",
"description": "2-Letter Country Code",
"nullable": true
},
"country": {
"type": "string",
"description": "Country",
"nullable": true
},
"addressCode": {
"type": "string",
"description": "Address Code",
"nullable": true
},
"lockUNLOCO": {
"type": "boolean"
},
"longitude": {
"type": "number",
"description": "Longitude",
"format": "double",
"nullable": true
},
"latitude": {
"type": "number",
"description": "Latitude",
"format": "double",
"nullable": true
},
"dateModified": {
"type": "string",
"description": "Date Modified",
"format": "date-time",
"nullable": true
},
"userModified": {
"type": "string",
"description": "User Modified",
"nullable": true
},
"dateCreated": {
"type": "string",
"description": "Creation Date",
"format": "date-time",
"nullable": true
},
"userCreated": {
"type": "string",
"description": "User creating the address",
"nullable": true
}
},
"additionalProperties": false
},
"eDC.Web.Api.v2.Models.Entities.Booking": {
"type": "object",
"properties": {
"bookingNumber": {
"type": "string",
"description": "Booking Number",
"nullable": true
},
"externalBookingNumber": {
"type": "string",
"description": "External Booking Number",
"nullable": true
},
"externalBookingSender": {
"type": "string",
"description": "External Booking Sender",
"nullable": true
},
"state": {
"$ref": "#/components/schemas/eDC.Domain.Enums.BookingState"
},
"origin": {
"type": "string",
"description": "Origin of the Booking",
"nullable": true
},
"destination": {
"type": "string",
"description": "Destination of the Booking",
"nullable": true
},
"incoterm": {
"type": "string",
"description": "Incoterm of the Booking",
"nullable": true
},
"additionalTerms": {
"type": "string",
"description": "Additional Terms of the Booking",
"nullable": true
},
"additionalTermsUNLOCO": {
"type": "string",
"description": "UN Location Code",
"nullable": true
},
"freightTerm": {
"type": "string",
"description": "Freight Terms",
"nullable": true
},
"orderNumbers": {
"type": "string",
"description": "Order Numbers",
"nullable": true
},
"unitOfWeight": {
"type": "string",
"description": "Unit of Measure for Weight",
"nullable": true
},
"weight": {
"type": "number",
"description": "Weight",
"format": "double"
},
"unitOfVolume": {
"type": "string",
"description": "Unit of Measure for Volume",
"nullable": true
},
"volume": {
"type": "number",
"description": "Volume",
"format": "double"
},
"noOfPieces": {
"type": "integer",
"description": "Number of Pieces",
"format": "int32"
},
"orderCurrency": {
"type": "string",
"description": "Currency for the Order",
"nullable": true
},
"totalValue": {
"type": "number",
"description": "Total Value of the Order",
"format": "double"
},
"packingWeight": {
"type": "number",
"description": "Packing Weight",
"format": "double"
},
"packingVolume": {
"type": "number",
"description": "Packing Volume",
"format": "double"
},
"transitWarehouse": {
"type": "string",
"description": "Transit Warehouse",
"nullable": true
},
"onHandDate": {
"type": "string",
"description": "On Hand Date",
"format": "date-time",
"nullable": true
},
"preBooked": {
"type": "string",
"format": "date-time",
"nullable": true
},
"bookedDate": {
"type": "string",
"description": "Date of Booking",
"format": "date-time",
"nullable": true
},
"rejectedDate": {
"type": "string",
"description": "Date of Booking Rejection",
"format": "date-time",
"nullable": true
},
"approvedDate": {
"type": "string",
"description": "Date of Booking Approval",
"format": "date-time",
"nullable": true
},
"confirmedDate": {
"type": "string",
"description": "Date of Booking Confirmation",
"format": "date-time",
"nullable": true
},
"cancelledDate": {
"type": "string",
"description": "Date of Booking Cancellation",
"format": "date-time",
"nullable": true
},
"countOfTEU": {
"type": "number",
"description": "TEU count",
"format": "double"
},
"countOf20FT": {
"type": "integer",
"description": "Count of 20ft Container",
"format": "int32"
},
"countOf40FT": {
"type": "integer",
"description": "Count of 40ft Container",
"format": "int32"
},
"countOf45FT": {
"type": "integer",
"description": "Count of 45ft Container",
"format": "int32"
},
"source": {
"type": "string",
"description": "Source",
"nullable": true
},
"systemID": {
"type": "st
# --- truncated at 32 KB (166 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dsv/refs/heads/main/openapi/dsv-edc-public-api-v2-openapi.json