{
  "opencollection": "1.0.0",
  "info": {
    "name": "ShipmentDocumentManagement",
    "version": "v2"
  },
  "request": {
    "auth": {
      "type": "oauth2",
      "flow": "implicit",
      "authorizationUrl": "https://gateway.api.kuehne-nagel.com/authorize",
      "credentials": {
        "clientId": "{{clientId}}"
      }
    }
  },
  "items": [
    {
      "info": {
        "name": "Download",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Download requested documents",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://gateway.api.kuehne-nagel.com/transport/execution/documentation/shipment/v2/documents",
            "params": [
              {
                "name": "referenceType",
                "value": "TRACKING_NUMBER",
                "type": "query",
                "description": "One of the references to search for.\n\nSupported reference types:\n* TRACKING_NUMBER\n* SHIPMENT_ID\n"
              },
              {
                "name": "referenceValue",
                "value": "3254325",
                "type": "query",
                "description": "Value of reference"
              },
              {
                "name": "documentCode",
                "value": "X91",
                "type": "query",
                "description": "Code of a document type according to the Kuehne+Nagel specific classification."
              }
            ],
            "auth": {
              "type": "oauth2",
              "flow": "implicit",
              "authorizationUrl": "https://gateway.api.kuehne-nagel.com/authorize",
              "credentials": {
                "clientId": "{{clientId}}"
              }
            }
          },
          "docs": "Returns all documents matching the parameters passed as request input payload.\n"
        }
      ]
    },
    {
      "info": {
        "name": "Upload",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "addDocument",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://gateway.api.kuehne-nagel.com/transport/execution/documentation/shipment/v2/shipments/:uniqueShipmentReference/documents",
            "params": [
              {
                "name": "uniqueShipmentReference",
                "value": "",
                "type": "path",
                "description": "By default this is the shipment __tracking number__ e.g. `N4242`.\n\nIn case a tracking number is not available a limited set of alternative references can be used.\nPlease use the track and trace API to first search for shipment details (e.g. by a customer specific reference)\nif none of the supported references are available .\n\nSupported references:\n* __tracking number__\n  * `{trackingNumber}` or `tracking-number:{trackingNumber}`\n  * e.g. `N4242` or `tracking-number:N4242`\n* __booking number__\n  * `booking-number:{bookingNumber}`\n  * e.g. `booking-number:B1`\n* __shipment id__\n  * `shipment-id:{shipmentId}`\n  * e.g. `shipment-id:S1`\n"
              }
            ],
            "body": {
              "type": "multipart-form",
              "data": []
            },
            "auth": {
              "type": "oauth2",
              "flow": "implicit",
              "authorizationUrl": "https://gateway.api.kuehne-nagel.com/authorize",
              "credentials": {
                "clientId": "{{clientId}}"
              }
            }
          },
          "docs": "Add a document to a specific shipment.\n\nBefore the document is actually added to the shipment the uploaded content must pass a\nsecurity scan and conversion to [PDF/A](https://en.wikipedia.org/wiki/PDF/A). This is done asynchronously\nand usually only takes a couple of seconds. For the future it is planned to immediately scan and convert the document.\n"
        },
        {
          "info": {
            "name": "retrieveDocumentDetails",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://gateway.api.kuehne-nagel.com/transport/execution/documentation/shipment/v2/shipments/:uniqueShipmentReference/documents/:documentId",
            "params": [
              {
                "name": "uniqueShipmentReference",
                "value": "",
                "type": "path",
                "description": "By default this is the shipment __tracking number__ e.g. `N4242`.\n\nIn case a tracking number is not available a limited set of alternative references can be used.\nPlease use the track and trace API to first search for shipment details (e.g. by a customer specific reference)\nif none of the supported references are available .\n\nSupported references:\n* __tracking number__\n  * `{trackingNumber}` or `tracking-number:{trackingNumber}`\n  * e.g. `N4242` or `tracking-number:N4242`\n* __booking number__\n  * `booking-number:{bookingNumber}`\n  * e.g. `booking-number:B1`\n* __shipment id__\n  * `shipment-id:{shipmentId}`\n  * e.g. `shipment-id:S1`\n"
              },
              {
                "name": "documentId",
                "value": "",
                "type": "path",
                "description": "Unique identifier of a document"
              }
            ],
            "auth": {
              "type": "oauth2",
              "flow": "implicit",
              "authorizationUrl": "https://gateway.api.kuehne-nagel.com/authorize",
              "credentials": {
                "clientId": "{{clientId}}"
              }
            }
          },
          "docs": "Retrieve meta data of a specific shipment document."
        },
        {
          "info": {
            "name": "retrieveUploadableDocumentTypes",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://gateway.api.kuehne-nagel.com/transport/execution/documentation/shipment/v2/shipments/:uniqueShipmentReference/uploadable-document-types",
            "params": [
              {
                "name": "uniqueShipmentReference",
                "value": "",
                "type": "path",
                "description": "By default this is the shipment __tracking number__ e.g. `N4242`.\n\nIn case a tracking number is not available a limited set of alternative references can be used.\nPlease use the track and trace API to first search for shipment details (e.g. by a customer specific reference)\nif none of the supported references are available .\n\nSupported references:\n* __tracking number__\n  * `{trackingNumber}` or `tracking-number:{trackingNumber}`\n  * e.g. `N4242` or `tracking-number:N4242`\n* __booking number__\n  * `booking-number:{bookingNumber}`\n  * e.g. `booking-number:B1`\n* __shipment id__\n  * `shipment-id:{shipmentId}`\n  * e.g. `shipment-id:S1`\n"
              }
            ],
            "auth": {
              "type": "oauth2",
              "flow": "implicit",
              "authorizationUrl": "https://gateway.api.kuehne-nagel.com/authorize",
              "credentials": {
                "clientId": "{{clientId}}"
              }
            }
          },
          "docs": "Retrieve the document types that can be used to add a document to the specific shipment."
        }
      ]
    }
  ],
  "bundled": true
}