--- title: Parcel slug: fourkites-api-reference/parcel icon: {"apiMethod":"PATCH"} createdAt: 2024-04-23T08:51:00.000Z --- To update your Parcel load without any hassle, follow the instructions given within this document. :::hint{type="info"} If you receive a server error **(5xx error code)**, please try again a few times. It's best to wait a little longer between each retry attempt. Try at least 3-5 times before giving up, as many server issues resolve themselves quickly. ::: :::hint{type="info"} ### Rate Limit **1 request per second** ::: :::hint{type="info"} ### Format Supported **JSON** ::: :::hint{type="info"} ### Authenticated Resource **API Key** ::: For more information on Authentication, [click here](https://docs.fourkites.com/api-reference/authentication). :::hint{type="success"} The FourKites internal loadId that is returned during load creation should be added to the endpoint to update the load. Click on the load that you would like to update to get the FourKites Internal LoadId as shown in the image below. ![](https://api.archbee.com/api/optimize/2iLZ8zq0u-v-CPzk98WTR/jke23hF7rks2Qo7PfinnW_id.jpg) ::: :::ApiMethodV2 ```json { "name": "Production", "method": "PATCH", "url": "https://api.fourkites.com/api/v1/tracking/417537760", "description": "", "tab": "examples", "examples": { "languages": [ { "id": "wR1OWhW9o2iM2rrEKy6Cw", "language": "curl", "code": "curl --location --request PATCH 'https://api.fourkites.com/api/v1/tracking/417537760' \\\n--header 'Content-Type: application/json' \\\n--header 'apikey: REPLACE_KEY_VALUE' \\\n--data-raw '{\n \"simpleUpdate\": \"True\",\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"truckNumber\": \"\",\n \"trailerNumber\": \"\"\n },\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"Parcel\"\n }\n },\n \"load\": {\n \"carrier\": \"cc79\",\n \"haulType\": [\n \"outbound_load\"\n ],\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"masterSequenceNumber\": null,\n \"simultaneousTrackingSequenceNumber\": 1,\n \"trackingNumber\": \"1122334455\",\n \"loadNumber\": \"TestParcelUpdate\",\n \"priority\": \"normal\",\n \"referenceNumbers\": [\n \"LID:3454353,43534535\",\n \"BOL:5343,764345\",\n \"TMSID:L23432\",\n \"L34535\",\n \"SCAC:SER1\"\n ],\n \"relayLoad\": false,\n \"stops\": [\n {\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Suite 3300\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"name\": \"FourKites HQ\",\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 1,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D43\",\n \"stopType\": \"pickup\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": true,\n \"customer\": {\n \"id\": null,\n \"poNumbers\": [\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"xyz@fourkites.com\",\n \"phone\": \"545454\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"earliestWantTime\": \"2024-04-21T16:31:29\",\n \"latestWantTime\": \"2024-04-21T16:31:29\",\n \"pallets\": [\n {\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25.0,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125.00,\n \"freightCost\": 10.00,\n \"bestBeforeDate\": \"2024-04-25T00:00:00Z\",\n \"additionalCharges\": 5.00,\n \"tariffCost\": 2.50,\n \"fourKitesCalculatedTariffCost\": 2.50,\n \"totalLandedCost\": 132.50,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D43\",\n \"handlingUnitId\": \"1KYGQ\",\n \"barcode\": \"1KYGQ\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678905\",\n \"customerPartNumber\": \"1KYGQ\",\n \"supplierPartNumber\": \"1KYGQ\",\n \"manufacturerPartNumber\": \"MFG-1KYGQ\",\n \"itemNumber\": \"ITM-1KYGQ\",\n \"productUpc\": \"012345678905\",\n \"deliveryReferences\": [\"BOL:43489495\"],\n \"orderReferences\": [\"SO:G024307300\"],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGQ\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"RFID_TAG\"\n }\n ]\n },\n {\n \"addressLine1\": \"425 South Palos Verdes Street\",\n \"addressLine2\": \"\",\n \"city\": \"Los Angeles\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": 1453242,\n \"poNumbers\": [\n \"04112024\",\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"abc@fourkites.com\",\n \"phone\": \"1234456734\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"earliestWantTime\": \"2024-04-22T16:31:29\",\n \"latestWantTime\": \"2024-04-22T16:31:29\",\n \"name\": \"Hammond, LA DC\",\n \"pallets\": [\n {\n \"billOfLading\": 43489495,\n \"number\": \"00001\",\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"postalCode\": \"70401\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 2,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D41\",\n \"stopType\": \"delivery\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": true,\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25.0,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125.00,\n \"freightCost\": 10.00,\n \"additionalCharges\": 5.00,\n \"tariffCost\": 2.50,\n \"fourKitesCalculatedTariffCost\": 2.50,\n \"totalLandedCost\": 132.50,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D41\",\n \"handlingUnitId\": \"00001\",\n \"barcode\": \"1KYGR\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678912\",\n \"customerPartNumber\": \"1KYGR\",\n \"supplierPartNumber\": \"1KYGR\",\n \"manufacturerPartNumber\": \"MFG-1KYGR\",\n \"itemNumber\": \"ITM-1KYGR\",\n \"productUpc\": \"012345678912\",\n \"deliveryReferences\": [\"BOL:43489495\"],\n \"orderReferences\": [\"SO:G024307300\"],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGR\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"QR_CODE\"\n }\n ]\n }\n ]\n }\n}'", "customLabel": "" }, { "id": "HylwcpcCE9BW0gTLbtHLy", "language": "java", "code": "OkHttpClient client = new OkHttpClient().newBuilder()\n .build();\nMediaType mediaType = MediaType.parse(\"application/json\");\nRequestBody body = RequestBody.create(mediaType, \"{\\n \\\"simpleUpdate\\\": \\\"True\\\",\\n \\\"trackingInfo\\\": {\\n \\\"driverPhone\\\": \\\"\\\",\\n \\\"truckNumber\\\": \\\"\\\",\\n \\\"trailerNumber\\\": \\\"\\\"\\n },\\n \\\"additionalData\\\": {\\n \\\"modeDetails\\\": {\\n \\\"shipperModes\\\": \\\"Parcel\\\"\\n }\\n },\\n \\\"load\\\": {\\n \\\"carrier\\\": \\\"cc79\\\",\\n \\\"haulType\\\": [\\n \\\"outbound_load\\\"\\n ],\\n \\\"simultaneousTrackingReferenceNumber\\\": \\\"simul123\\\",\\n \\\"masterSequenceNumber\\\": null,\\n \\\"simultaneousTrackingSequenceNumber\\\": 1,\\n \\\"trackingNumber\\\": \\\"1122334455\\\",\\n \\\"loadNumber\\\": \\\"TestParcelUpdate\\\",\\n \\\"priority\\\": \\\"normal\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"LID:3454353,43534535\\\",\\n \\\"BOL:5343,764345\\\",\\n \\\"TMSID:L23432\\\",\\n \\\"L34535\\\",\\n \\\"SCAC:SER1\\\"\\n ],\\n \\\"relayLoad\\\": false,\\n \\\"stops\\\": [\\n {\\n \\\"addressLine1\\\": \\\"500 West Madison Street\\\",\\n \\\"addressLine2\\\": \\\"Suite 3300\\\",\\n \\\"city\\\": \\\"Chicago\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"name\\\": \\\"FourKites HQ\\\",\\n \\\"postalCode\\\": \\\"60611\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"STNR:D43\\\",\\n \\\"BOL:43489495\\\",\\n \\\"43489495\\\",\\n \\\"SO:G024307300\\\"\\n ],\\n \\\"sequence\\\": 1,\\n \\\"state\\\": \\\"LA\\\",\\n \\\"stopReferenceId\\\": \\\"D43\\\",\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"unloadTimeInMinutes\\\": 120,\\n \\\"timeInUtc\\\": true,\\n \\\"customer\\\": {\\n \\\"id\\\": null,\\n \\\"poNumbers\\\": [\\n \\\"04112024\\\"\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"email\\\": \\\"xyz@fourkites.com\\\",\\n \\\"phone\\\": \\\"545454\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2024-04-21T19:16:15\\\",\\n \\\"latestAppointmentTime\\\": \\\"2024-04-21T19:16:15\\\",\\n \\\"earliestWantTime\\\": \\\"2024-04-21T16:31:29\\\",\\n \\\"latestWantTime\\\": \\\"2024-04-21T16:31:29\\\",\\n \\\"pallets\\\": [\\n {\\n \\\"parts\\\": [\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"weight\\\": \\\"7.998\\\"\\n },\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGR\\\",\\n \\\"weight\\\": \\\"36.800\\\"\\n }\\n ]\\n }\\n ],\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"0123456\\\",\\n \\\"productName\\\": \\\"Parcel Item\\\",\\n \\\"productDescription\\\": \\\"Parcel shipment item\\\",\\n \\\"productCategory\\\": \\\"General Merchandise\\\",\\n \\\"quantity\\\": 5,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 44.8,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 25.0,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 125.00,\\n \\\"freightCost\\\": 10.00,\\n \\\"bestBeforeDate\\\": \\\"2024-04-25T00:00:00Z\\\",\\n \\\"additionalCharges\\\": 5.00,\\n \\\"tariffCost\\\": 2.50,\\n \\\"fourKitesCalculatedTariffCost\\\": 2.50,\\n \\\"totalLandedCost\\\": 132.50,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"4819500000\\\",\\n \\\"commodityTypeCode\\\": \\\"GENERAL_MERCHANDISE\\\",\\n \\\"htsusCode\\\": \\\"4819500000\\\",\\n \\\"orderNumber\\\": \\\"04112024\\\",\\n \\\"deliveryNumber\\\": \\\"DN-D43\\\",\\n \\\"handlingUnitId\\\": \\\"1KYGQ\\\",\\n \\\"barcode\\\": \\\"1KYGQ\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"00012345678905\\\",\\n \\\"customerPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"supplierPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-1KYGQ\\\",\\n \\\"itemNumber\\\": \\\"ITM-1KYGQ\\\",\\n \\\"productUpc\\\": \\\"012345678905\\\",\\n \\\"deliveryReferences\\\": [\\\"BOL:43489495\\\"],\\n \\\"orderReferences\\\": [\\\"SO:G024307300\\\"],\\n \\\"brandName\\\": \\\"Generic Merchandise Co\\\",\\n \\\"minimumTemperature\\\": 0,\\n \\\"maximumTemperature\\\": 0,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-1KYGQ\\\",\\n \\\"productTrackingNumber\\\": \\\"1122334455\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n }\\n ]\\n },\\n {\\n \\\"addressLine1\\\": \\\"425 South Palos Verdes Street\\\",\\n \\\"addressLine2\\\": \\\"\\\",\\n \\\"city\\\": \\\"Los Angeles\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": 1453242,\\n \\\"poNumbers\\\": [\\n \\\"04112024\\\",\\n \\\"04112024\\\"\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"email\\\": \\\"abc@fourkites.com\\\",\\n \\\"phone\\\": \\\"1234456734\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2024-04-22T19:16:15\\\",\\n \\\"latestAppointmentTime\\\": \\\"2024-04-22T19:16:15\\\",\\n \\\"earliestWantTime\\\": \\\"2024-04-22T16:31:29\\\",\\n \\\"latestWantTime\\\": \\\"2024-04-22T16:31:29\\\",\\n \\\"name\\\": \\\"Hammond, LA DC\\\",\\n \\\"pallets\\\": [\\n {\\n \\\"billOfLading\\\": 43489495,\\n \\\"number\\\": \\\"00001\\\",\\n \\\"parts\\\": [\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"weight\\\": \\\"7.998\\\"\\n },\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGR\\\",\\n \\\"weight\\\": \\\"36.800\\\"\\n }\\n ]\\n }\\n ],\\n \\\"postalCode\\\": \\\"70401\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"STNR:D43\\\",\\n \\\"BOL:43489495\\\",\\n \\\"43489495\\\",\\n \\\"SO:G024307300\\\"\\n ],\\n \\\"sequence\\\": 2,\\n \\\"state\\\": \\\"LA\\\",\\n \\\"stopReferenceId\\\": \\\"D41\\\",\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"unloadTimeInMinutes\\\": 120,\\n \\\"timeInUtc\\\": true,\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"0123456\\\",\\n \\\"productName\\\": \\\"Parcel Item\\\",\\n \\\"productDescription\\\": \\\"Parcel shipment item\\\",\\n \\\"productCategory\\\": \\\"General Merchandise\\\",\\n \\\"quantity\\\": 5,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 44.8,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 25.0,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 125.00,\\n \\\"freightCost\\\": 10.00,\\n \\\"additionalCharges\\\": 5.00,\\n \\\"tariffCost\\\": 2.50,\\n \\\"fourKitesCalculatedTariffCost\\\": 2.50,\\n \\\"totalLandedCost\\\": 132.50,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"4819500000\\\",\\n \\\"commodityTypeCode\\\": \\\"GENERAL_MERCHANDISE\\\",\\n \\\"htsusCode\\\": \\\"4819500000\\\",\\n \\\"orderNumber\\\": \\\"04112024\\\",\\n \\\"deliveryNumber\\\": \\\"DN-D41\\\",\\n \\\"handlingUnitId\\\": \\\"00001\\\",\\n \\\"barcode\\\": \\\"1KYGR\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"00012345678912\\\",\\n \\\"customerPartNumber\\\": \\\"1KYGR\\\",\\n \\\"supplierPartNumber\\\": \\\"1KYGR\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-1KYGR\\\",\\n \\\"itemNumber\\\": \\\"ITM-1KYGR\\\",\\n \\\"productUpc\\\": \\\"012345678912\\\",\\n \\\"deliveryReferences\\\": [\\\"BOL:43489495\\\"],\\n \\\"orderReferences\\\": [\\\"SO:G024307300\\\"],\\n \\\"brandName\\\": \\\"Generic Merchandise Co\\\",\\n \\\"minimumTemperature\\\": 0,\\n \\\"maximumTemperature\\\": 0,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-1KYGR\\\",\\n \\\"productTrackingNumber\\\": \\\"1122334455\\\",\\n \\\"deviceType\\\": \\\"QR_CODE\\\"\\n }\\n ]\\n }\\n ]\\n }\\n}\");\nRequest request = new Request.Builder()\n .url(\"https://api.fourkites.com/api/v1/tracking/417537760\")\n .method(\"PATCH\", body)\n .addHeader(\"Content-Type\", \"application/json\")\n .addHeader(\"apikey\", \"REPLACE_KEY_VALUE\")\n .build();\nResponse response = client.newCall(request).execute();", "customLabel": "" }, { "id": "fYOeDccneaOBAVR2bSIT3", "language": "javascript", "code": "var settings = {\n \"url\": \"https://api.fourkites.com/api/v1/tracking/417537760\",\n \"method\": \"PATCH\",\n \"timeout\": 0,\n \"headers\": {\n \"Content-Type\": \"application/json\",\n \"apikey\": \"REPLACE_KEY_VALUE\"\n },\n \"data\": JSON.stringify({\n \"simpleUpdate\": \"True\",\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"truckNumber\": \"\",\n \"trailerNumber\": \"\"\n },\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"Parcel\"\n }\n },\n \"load\": {\n \"carrier\": \"cc79\",\n \"haulType\": [\n \"outbound_load\"\n ],\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"masterSequenceNumber\": null,\n \"simultaneousTrackingSequenceNumber\": 1,\n \"trackingNumber\": \"1122334455\",\n \"loadNumber\": \"TestParcelUpdate\",\n \"priority\": \"normal\",\n \"referenceNumbers\": [\n \"LID:3454353,43534535\",\n \"BOL:5343,764345\",\n \"TMSID:L23432\",\n \"L34535\",\n \"SCAC:SER1\"\n ],\n \"relayLoad\": false,\n \"stops\": [\n {\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Suite 3300\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"name\": \"FourKites HQ\",\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 1,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D43\",\n \"stopType\": \"pickup\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": true,\n \"customer\": {\n \"id\": null,\n \"poNumbers\": [\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"xyz@fourkites.com\",\n \"phone\": \"545454\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"earliestWantTime\": \"2024-04-21T16:31:29\",\n \"latestWantTime\": \"2024-04-21T16:31:29\",\n \"pallets\": [\n {\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125,\n \"freightCost\": 10,\n \"bestBeforeDate\": \"2024-04-25T00:00:00Z\",\n \"additionalCharges\": 5,\n \"tariffCost\": 2.5,\n \"fourKitesCalculatedTariffCost\": 2.5,\n \"totalLandedCost\": 132.5,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D43\",\n \"handlingUnitId\": \"1KYGQ\",\n \"barcode\": \"1KYGQ\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678905\",\n \"customerPartNumber\": \"1KYGQ\",\n \"supplierPartNumber\": \"1KYGQ\",\n \"manufacturerPartNumber\": \"MFG-1KYGQ\",\n \"itemNumber\": \"ITM-1KYGQ\",\n \"productUpc\": \"012345678905\",\n \"deliveryReferences\": [\n \"BOL:43489495\"\n ],\n \"orderReferences\": [\n \"SO:G024307300\"\n ],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGQ\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"RFID_TAG\"\n }\n ]\n },\n {\n \"addressLine1\": \"425 South Palos Verdes Street\",\n \"addressLine2\": \"\",\n \"city\": \"Los Angeles\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": 1453242,\n \"poNumbers\": [\n \"04112024\",\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"abc@fourkites.com\",\n \"phone\": \"1234456734\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"earliestWantTime\": \"2024-04-22T16:31:29\",\n \"latestWantTime\": \"2024-04-22T16:31:29\",\n \"name\": \"Hammond, LA DC\",\n \"pallets\": [\n {\n \"billOfLading\": 43489495,\n \"number\": \"00001\",\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"postalCode\": \"70401\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 2,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D41\",\n \"stopType\": \"delivery\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": true,\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125,\n \"freightCost\": 10,\n \"additionalCharges\": 5,\n \"tariffCost\": 2.5,\n \"fourKitesCalculatedTariffCost\": 2.5,\n \"totalLandedCost\": 132.5,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D41\",\n \"handlingUnitId\": \"00001\",\n \"barcode\": \"1KYGR\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678912\",\n \"customerPartNumber\": \"1KYGR\",\n \"supplierPartNumber\": \"1KYGR\",\n \"manufacturerPartNumber\": \"MFG-1KYGR\",\n \"itemNumber\": \"ITM-1KYGR\",\n \"productUpc\": \"012345678912\",\n \"deliveryReferences\": [\n \"BOL:43489495\"\n ],\n \"orderReferences\": [\n \"SO:G024307300\"\n ],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGR\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"QR_CODE\"\n }\n ]\n }\n ]\n }\n }),\n};\n\n$.ajax(settings).done(function (response) {\n console.log(response);\n});", "customLabel": "" }, { "id": "Wa5iZnk2mQYNur1oRW3cy", "language": "swift", "code": "let parameters = \"{\\n \\\"simpleUpdate\\\": \\\"True\\\",\\n \\\"trackingInfo\\\": {\\n \\\"driverPhone\\\": \\\"\\\",\\n \\\"truckNumber\\\": \\\"\\\",\\n \\\"trailerNumber\\\": \\\"\\\"\\n },\\n \\\"additionalData\\\": {\\n \\\"modeDetails\\\": {\\n \\\"shipperModes\\\": \\\"Parcel\\\"\\n }\\n },\\n \\\"load\\\": {\\n \\\"carrier\\\": \\\"cc79\\\",\\n \\\"haulType\\\": [\\n \\\"outbound_load\\\"\\n ],\\n \\\"simultaneousTrackingReferenceNumber\\\": \\\"simul123\\\",\\n \\\"masterSequenceNumber\\\": null,\\n \\\"simultaneousTrackingSequenceNumber\\\": 1,\\n \\\"trackingNumber\\\": \\\"1122334455\\\",\\n \\\"loadNumber\\\": \\\"TestParcelUpdate\\\",\\n \\\"priority\\\": \\\"normal\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"LID:3454353,43534535\\\",\\n \\\"BOL:5343,764345\\\",\\n \\\"TMSID:L23432\\\",\\n \\\"L34535\\\",\\n \\\"SCAC:SER1\\\"\\n ],\\n \\\"relayLoad\\\": false,\\n \\\"stops\\\": [\\n {\\n \\\"addressLine1\\\": \\\"500 West Madison Street\\\",\\n \\\"addressLine2\\\": \\\"Suite 3300\\\",\\n \\\"city\\\": \\\"Chicago\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"name\\\": \\\"FourKites HQ\\\",\\n \\\"postalCode\\\": \\\"60611\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"STNR:D43\\\",\\n \\\"BOL:43489495\\\",\\n \\\"43489495\\\",\\n \\\"SO:G024307300\\\"\\n ],\\n \\\"sequence\\\": 1,\\n \\\"state\\\": \\\"LA\\\",\\n \\\"stopReferenceId\\\": \\\"D43\\\",\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"unloadTimeInMinutes\\\": 120,\\n \\\"timeInUtc\\\": true,\\n \\\"customer\\\": {\\n \\\"id\\\": null,\\n \\\"poNumbers\\\": [\\n \\\"04112024\\\"\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"email\\\": \\\"xyz@fourkites.com\\\",\\n \\\"phone\\\": \\\"545454\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2024-04-21T19:16:15\\\",\\n \\\"latestAppointmentTime\\\": \\\"2024-04-21T19:16:15\\\",\\n \\\"earliestWantTime\\\": \\\"2024-04-21T16:31:29\\\",\\n \\\"latestWantTime\\\": \\\"2024-04-21T16:31:29\\\",\\n \\\"pallets\\\": [\\n {\\n \\\"parts\\\": [\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"weight\\\": \\\"7.998\\\"\\n },\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGR\\\",\\n \\\"weight\\\": \\\"36.800\\\"\\n }\\n ]\\n }\\n ],\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"0123456\\\",\\n \\\"productName\\\": \\\"Parcel Item\\\",\\n \\\"productDescription\\\": \\\"Parcel shipment item\\\",\\n \\\"productCategory\\\": \\\"General Merchandise\\\",\\n \\\"quantity\\\": 5,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 44.8,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 25.0,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 125.00,\\n \\\"freightCost\\\": 10.00,\\n \\\"bestBeforeDate\\\": \\\"2024-04-25T00:00:00Z\\\",\\n \\\"additionalCharges\\\": 5.00,\\n \\\"tariffCost\\\": 2.50,\\n \\\"fourKitesCalculatedTariffCost\\\": 2.50,\\n \\\"totalLandedCost\\\": 132.50,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"4819500000\\\",\\n \\\"commodityTypeCode\\\": \\\"GENERAL_MERCHANDISE\\\",\\n \\\"htsusCode\\\": \\\"4819500000\\\",\\n \\\"orderNumber\\\": \\\"04112024\\\",\\n \\\"deliveryNumber\\\": \\\"DN-D43\\\",\\n \\\"handlingUnitId\\\": \\\"1KYGQ\\\",\\n \\\"barcode\\\": \\\"1KYGQ\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"00012345678905\\\",\\n \\\"customerPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"supplierPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-1KYGQ\\\",\\n \\\"itemNumber\\\": \\\"ITM-1KYGQ\\\",\\n \\\"productUpc\\\": \\\"012345678905\\\",\\n \\\"deliveryReferences\\\": [\\\"BOL:43489495\\\"],\\n \\\"orderReferences\\\": [\\\"SO:G024307300\\\"],\\n \\\"brandName\\\": \\\"Generic Merchandise Co\\\",\\n \\\"minimumTemperature\\\": 0,\\n \\\"maximumTemperature\\\": 0,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-1KYGQ\\\",\\n \\\"productTrackingNumber\\\": \\\"1122334455\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n }\\n ]\\n },\\n {\\n \\\"addressLine1\\\": \\\"425 South Palos Verdes Street\\\",\\n \\\"addressLine2\\\": \\\"\\\",\\n \\\"city\\\": \\\"Los Angeles\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": 1453242,\\n \\\"poNumbers\\\": [\\n \\\"04112024\\\",\\n \\\"04112024\\\"\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"email\\\": \\\"abc@fourkites.com\\\",\\n \\\"phone\\\": \\\"1234456734\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2024-04-22T19:16:15\\\",\\n \\\"latestAppointmentTime\\\": \\\"2024-04-22T19:16:15\\\",\\n \\\"earliestWantTime\\\": \\\"2024-04-22T16:31:29\\\",\\n \\\"latestWantTime\\\": \\\"2024-04-22T16:31:29\\\",\\n \\\"name\\\": \\\"Hammond, LA DC\\\",\\n \\\"pallets\\\": [\\n {\\n \\\"billOfLading\\\": 43489495,\\n \\\"number\\\": \\\"00001\\\",\\n \\\"parts\\\": [\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"weight\\\": \\\"7.998\\\"\\n },\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGR\\\",\\n \\\"weight\\\": \\\"36.800\\\"\\n }\\n ]\\n }\\n ],\\n \\\"postalCode\\\": \\\"70401\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"STNR:D43\\\",\\n \\\"BOL:43489495\\\",\\n \\\"43489495\\\",\\n \\\"SO:G024307300\\\"\\n ],\\n \\\"sequence\\\": 2,\\n \\\"state\\\": \\\"LA\\\",\\n \\\"stopReferenceId\\\": \\\"D41\\\",\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"unloadTimeInMinutes\\\": 120,\\n \\\"timeInUtc\\\": true,\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"0123456\\\",\\n \\\"productName\\\": \\\"Parcel Item\\\",\\n \\\"productDescription\\\": \\\"Parcel shipment item\\\",\\n \\\"productCategory\\\": \\\"General Merchandise\\\",\\n \\\"quantity\\\": 5,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 44.8,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 25.0,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 125.00,\\n \\\"freightCost\\\": 10.00,\\n \\\"additionalCharges\\\": 5.00,\\n \\\"tariffCost\\\": 2.50,\\n \\\"fourKitesCalculatedTariffCost\\\": 2.50,\\n \\\"totalLandedCost\\\": 132.50,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"4819500000\\\",\\n \\\"commodityTypeCode\\\": \\\"GENERAL_MERCHANDISE\\\",\\n \\\"htsusCode\\\": \\\"4819500000\\\",\\n \\\"orderNumber\\\": \\\"04112024\\\",\\n \\\"deliveryNumber\\\": \\\"DN-D41\\\",\\n \\\"handlingUnitId\\\": \\\"00001\\\",\\n \\\"barcode\\\": \\\"1KYGR\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"00012345678912\\\",\\n \\\"customerPartNumber\\\": \\\"1KYGR\\\",\\n \\\"supplierPartNumber\\\": \\\"1KYGR\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-1KYGR\\\",\\n \\\"itemNumber\\\": \\\"ITM-1KYGR\\\",\\n \\\"productUpc\\\": \\\"012345678912\\\",\\n \\\"deliveryReferences\\\": [\\\"BOL:43489495\\\"],\\n \\\"orderReferences\\\": [\\\"SO:G024307300\\\"],\\n \\\"brandName\\\": \\\"Generic Merchandise Co\\\",\\n \\\"minimumTemperature\\\": 0,\\n \\\"maximumTemperature\\\": 0,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-1KYGR\\\",\\n \\\"productTrackingNumber\\\": \\\"1122334455\\\",\\n \\\"deviceType\\\": \\\"QR_CODE\\\"\\n }\\n ]\\n }\\n ]\\n }\\n}\"\nlet postData = parameters.data(using: .utf8)\n\nvar request = URLRequest(url: URL(string: \"https://api.fourkites.com/api/v1/tracking/417537760\")!,timeoutInterval: Double.infinity)\nrequest.addValue(\"application/json\", forHTTPHeaderField: \"Content-Type\")\nrequest.addValue(\"REPLACE_KEY_VALUE\", forHTTPHeaderField: \"apikey\")\n\nrequest.httpMethod = \"PATCH\"\nrequest.httpBody = postData\n\nlet task = URLSession.shared.dataTask(with: request) { data, response, error in \n guard let data = data else {\n print(String(describing: error))\n return\n }\n print(String(data: data, encoding: .utf8)!)\n}\n\ntask.resume()\n", "customLabel": "" }, { "id": "HniLgknzNj5Bx76jN_m0T", "language": "csharp", "code": "var client = new HttpClient();\nvar request = new HttpRequestMessage(HttpMethod.Patch, \"https://api.fourkites.com/api/v1/tracking/417537760\");\nrequest.Headers.Add(\"apikey\", \"REPLACE_KEY_VALUE\");\nvar content = new StringContent(\"{\\n \\\"simpleUpdate\\\": \\\"True\\\",\\n \\\"trackingInfo\\\": {\\n \\\"driverPhone\\\": \\\"\\\",\\n \\\"truckNumber\\\": \\\"\\\",\\n \\\"trailerNumber\\\": \\\"\\\"\\n },\\n \\\"additionalData\\\": {\\n \\\"modeDetails\\\": {\\n \\\"shipperModes\\\": \\\"Parcel\\\"\\n }\\n },\\n \\\"load\\\": {\\n \\\"carrier\\\": \\\"cc79\\\",\\n \\\"haulType\\\": [\\n \\\"outbound_load\\\"\\n ],\\n \\\"simultaneousTrackingReferenceNumber\\\": \\\"simul123\\\",\\n \\\"masterSequenceNumber\\\": null,\\n \\\"simultaneousTrackingSequenceNumber\\\": 1,\\n \\\"trackingNumber\\\": \\\"1122334455\\\",\\n \\\"loadNumber\\\": \\\"TestParcelUpdate\\\",\\n \\\"priority\\\": \\\"normal\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"LID:3454353,43534535\\\",\\n \\\"BOL:5343,764345\\\",\\n \\\"TMSID:L23432\\\",\\n \\\"L34535\\\",\\n \\\"SCAC:SER1\\\"\\n ],\\n \\\"relayLoad\\\": false,\\n \\\"stops\\\": [\\n {\\n \\\"addressLine1\\\": \\\"500 West Madison Street\\\",\\n \\\"addressLine2\\\": \\\"Suite 3300\\\",\\n \\\"city\\\": \\\"Chicago\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"name\\\": \\\"FourKites HQ\\\",\\n \\\"postalCode\\\": \\\"60611\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"STNR:D43\\\",\\n \\\"BOL:43489495\\\",\\n \\\"43489495\\\",\\n \\\"SO:G024307300\\\"\\n ],\\n \\\"sequence\\\": 1,\\n \\\"state\\\": \\\"LA\\\",\\n \\\"stopReferenceId\\\": \\\"D43\\\",\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"unloadTimeInMinutes\\\": 120,\\n \\\"timeInUtc\\\": true,\\n \\\"customer\\\": {\\n \\\"id\\\": null,\\n \\\"poNumbers\\\": [\\n \\\"04112024\\\"\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"email\\\": \\\"xyz@fourkites.com\\\",\\n \\\"phone\\\": \\\"545454\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2024-04-21T19:16:15\\\",\\n \\\"latestAppointmentTime\\\": \\\"2024-04-21T19:16:15\\\",\\n \\\"earliestWantTime\\\": \\\"2024-04-21T16:31:29\\\",\\n \\\"latestWantTime\\\": \\\"2024-04-21T16:31:29\\\",\\n \\\"pallets\\\": [\\n {\\n \\\"parts\\\": [\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"weight\\\": \\\"7.998\\\"\\n },\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGR\\\",\\n \\\"weight\\\": \\\"36.800\\\"\\n }\\n ]\\n }\\n ],\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"0123456\\\",\\n \\\"productName\\\": \\\"Parcel Item\\\",\\n \\\"productDescription\\\": \\\"Parcel shipment item\\\",\\n \\\"productCategory\\\": \\\"General Merchandise\\\",\\n \\\"quantity\\\": 5,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 44.8,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 25.0,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 125.00,\\n \\\"freightCost\\\": 10.00,\\n \\\"bestBeforeDate\\\": \\\"2024-04-25T00:00:00Z\\\",\\n \\\"additionalCharges\\\": 5.00,\\n \\\"tariffCost\\\": 2.50,\\n \\\"fourKitesCalculatedTariffCost\\\": 2.50,\\n \\\"totalLandedCost\\\": 132.50,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"4819500000\\\",\\n \\\"commodityTypeCode\\\": \\\"GENERAL_MERCHANDISE\\\",\\n \\\"htsusCode\\\": \\\"4819500000\\\",\\n \\\"orderNumber\\\": \\\"04112024\\\",\\n \\\"deliveryNumber\\\": \\\"DN-D43\\\",\\n \\\"handlingUnitId\\\": \\\"1KYGQ\\\",\\n \\\"barcode\\\": \\\"1KYGQ\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"00012345678905\\\",\\n \\\"customerPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"supplierPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-1KYGQ\\\",\\n \\\"itemNumber\\\": \\\"ITM-1KYGQ\\\",\\n \\\"productUpc\\\": \\\"012345678905\\\",\\n \\\"deliveryReferences\\\": [\\\"BOL:43489495\\\"],\\n \\\"orderReferences\\\": [\\\"SO:G024307300\\\"],\\n \\\"brandName\\\": \\\"Generic Merchandise Co\\\",\\n \\\"minimumTemperature\\\": 0,\\n \\\"maximumTemperature\\\": 0,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-1KYGQ\\\",\\n \\\"productTrackingNumber\\\": \\\"1122334455\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n }\\n ]\\n },\\n {\\n \\\"addressLine1\\\": \\\"425 South Palos Verdes Street\\\",\\n \\\"addressLine2\\\": \\\"\\\",\\n \\\"city\\\": \\\"Los Angeles\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": 1453242,\\n \\\"poNumbers\\\": [\\n \\\"04112024\\\",\\n \\\"04112024\\\"\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"email\\\": \\\"abc@fourkites.com\\\",\\n \\\"phone\\\": \\\"1234456734\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2024-04-22T19:16:15\\\",\\n \\\"latestAppointmentTime\\\": \\\"2024-04-22T19:16:15\\\",\\n \\\"earliestWantTime\\\": \\\"2024-04-22T16:31:29\\\",\\n \\\"latestWantTime\\\": \\\"2024-04-22T16:31:29\\\",\\n \\\"name\\\": \\\"Hammond, LA DC\\\",\\n \\\"pallets\\\": [\\n {\\n \\\"billOfLading\\\": 43489495,\\n \\\"number\\\": \\\"00001\\\",\\n \\\"parts\\\": [\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"weight\\\": \\\"7.998\\\"\\n },\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGR\\\",\\n \\\"weight\\\": \\\"36.800\\\"\\n }\\n ]\\n }\\n ],\\n \\\"postalCode\\\": \\\"70401\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"STNR:D43\\\",\\n \\\"BOL:43489495\\\",\\n \\\"43489495\\\",\\n \\\"SO:G024307300\\\"\\n ],\\n \\\"sequence\\\": 2,\\n \\\"state\\\": \\\"LA\\\",\\n \\\"stopReferenceId\\\": \\\"D41\\\",\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"unloadTimeInMinutes\\\": 120,\\n \\\"timeInUtc\\\": true,\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"0123456\\\",\\n \\\"productName\\\": \\\"Parcel Item\\\",\\n \\\"productDescription\\\": \\\"Parcel shipment item\\\",\\n \\\"productCategory\\\": \\\"General Merchandise\\\",\\n \\\"quantity\\\": 5,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 44.8,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 25.0,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 125.00,\\n \\\"freightCost\\\": 10.00,\\n \\\"additionalCharges\\\": 5.00,\\n \\\"tariffCost\\\": 2.50,\\n \\\"fourKitesCalculatedTariffCost\\\": 2.50,\\n \\\"totalLandedCost\\\": 132.50,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"4819500000\\\",\\n \\\"commodityTypeCode\\\": \\\"GENERAL_MERCHANDISE\\\",\\n \\\"htsusCode\\\": \\\"4819500000\\\",\\n \\\"orderNumber\\\": \\\"04112024\\\",\\n \\\"deliveryNumber\\\": \\\"DN-D41\\\",\\n \\\"handlingUnitId\\\": \\\"00001\\\",\\n \\\"barcode\\\": \\\"1KYGR\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"00012345678912\\\",\\n \\\"customerPartNumber\\\": \\\"1KYGR\\\",\\n \\\"supplierPartNumber\\\": \\\"1KYGR\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-1KYGR\\\",\\n \\\"itemNumber\\\": \\\"ITM-1KYGR\\\",\\n \\\"productUpc\\\": \\\"012345678912\\\",\\n \\\"deliveryReferences\\\": [\\\"BOL:43489495\\\"],\\n \\\"orderReferences\\\": [\\\"SO:G024307300\\\"],\\n \\\"brandName\\\": \\\"Generic Merchandise Co\\\",\\n \\\"minimumTemperature\\\": 0,\\n \\\"maximumTemperature\\\": 0,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-1KYGR\\\",\\n \\\"productTrackingNumber\\\": \\\"1122334455\\\",\\n \\\"deviceType\\\": \\\"QR_CODE\\\"\\n }\\n ]\\n }\\n ]\\n }\\n}\", null, \"application/json\");\nrequest.Content = content;\nvar response = await client.SendAsync(request);\nresponse.EnsureSuccessStatusCode();\nConsole.WriteLine(await response.Content.ReadAsStringAsync());\n", "customLabel": "" }, { "id": "9zcwM7HetabBQtdATlUj9", "language": "go", "code": "package main\n\nimport (\n \"fmt\"\n \"strings\"\n \"net/http\"\n \"io/ioutil\"\n)\n\nfunc main() {\n\n url := \"https://api.fourkites.com/api/v1/tracking/417537760\"\n method := \"PATCH\"\n\n payload := strings.NewReader(`{\n \"simpleUpdate\": \"True\",\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"truckNumber\": \"\",\n \"trailerNumber\": \"\"\n },\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"Parcel\"\n }\n },\n \"load\": {\n \"carrier\": \"cc79\",\n \"haulType\": [\n \"outbound_load\"\n ],\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"masterSequenceNumber\": null,\n \"simultaneousTrackingSequenceNumber\": 1,\n \"trackingNumber\": \"1122334455\",\n \"loadNumber\": \"TestParcelUpdate\",\n \"priority\": \"normal\",\n \"referenceNumbers\": [\n \"LID:3454353,43534535\",\n \"BOL:5343,764345\",\n \"TMSID:L23432\",\n \"L34535\",\n \"SCAC:SER1\"\n ],\n \"relayLoad\": false,\n \"stops\": [\n {\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Suite 3300\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"name\": \"FourKites HQ\",\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 1,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D43\",\n \"stopType\": \"pickup\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": true,\n \"customer\": {\n \"id\": null,\n \"poNumbers\": [\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"xyz@fourkites.com\",\n \"phone\": \"545454\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"earliestWantTime\": \"2024-04-21T16:31:29\",\n \"latestWantTime\": \"2024-04-21T16:31:29\",\n \"pallets\": [\n {\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25.0,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125.00,\n \"freightCost\": 10.00,\n \"bestBeforeDate\": \"2024-04-25T00:00:00Z\",\n \"additionalCharges\": 5.00,\n \"tariffCost\": 2.50,\n \"fourKitesCalculatedTariffCost\": 2.50,\n \"totalLandedCost\": 132.50,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D43\",\n \"handlingUnitId\": \"1KYGQ\",\n \"barcode\": \"1KYGQ\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678905\",\n \"customerPartNumber\": \"1KYGQ\",\n \"supplierPartNumber\": \"1KYGQ\",\n \"manufacturerPartNumber\": \"MFG-1KYGQ\",\n \"itemNumber\": \"ITM-1KYGQ\",\n \"productUpc\": \"012345678905\",\n \"deliveryReferences\": [\"BOL:43489495\"],\n \"orderReferences\": [\"SO:G024307300\"],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGQ\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"RFID_TAG\"\n }\n ]\n },\n {\n \"addressLine1\": \"425 South Palos Verdes Street\",\n \"addressLine2\": \"\",\n \"city\": \"Los Angeles\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": 1453242,\n \"poNumbers\": [\n \"04112024\",\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"abc@fourkites.com\",\n \"phone\": \"1234456734\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"earliestWantTime\": \"2024-04-22T16:31:29\",\n \"latestWantTime\": \"2024-04-22T16:31:29\",\n \"name\": \"Hammond, LA DC\",\n \"pallets\": [\n {\n \"billOfLading\": 43489495,\n \"number\": \"00001\",\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"postalCode\": \"70401\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 2,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D41\",\n \"stopType\": \"delivery\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": true,\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25.0,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125.00,\n \"freightCost\": 10.00,\n \"additionalCharges\": 5.00,\n \"tariffCost\": 2.50,\n \"fourKitesCalculatedTariffCost\": 2.50,\n \"totalLandedCost\": 132.50,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D41\",\n \"handlingUnitId\": \"00001\",\n \"barcode\": \"1KYGR\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678912\",\n \"customerPartNumber\": \"1KYGR\",\n \"supplierPartNumber\": \"1KYGR\",\n \"manufacturerPartNumber\": \"MFG-1KYGR\",\n \"itemNumber\": \"ITM-1KYGR\",\n \"productUpc\": \"012345678912\",\n \"deliveryReferences\": [\"BOL:43489495\"],\n \"orderReferences\": [\"SO:G024307300\"],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGR\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"QR_CODE\"\n }\n ]\n }\n ]\n }\n}`)\n\n client := &http.Client {\n }\n req, err := http.NewRequest(method, url, payload)\n\n if err != nil {\n fmt.Println(err)\n return\n }\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"apikey\", \"REPLACE_KEY_VALUE\")\n\n res, err := client.Do(req)\n if err != nil {\n fmt.Println(err)\n return\n }\n defer res.Body.Close()\n\n body, err := ioutil.ReadAll(res.Body)\n if err != nil {\n fmt.Println(err)\n return\n }\n fmt.Println(string(body))\n}", "customLabel": "" }, { "id": "O9by-LSR9sP8Q9TVUT5I8", "language": "ruby", "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api.fourkites.com/api/v1/tracking/417537760\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Patch.new(url)\nrequest[\"Content-Type\"] = \"application/json\"\nrequest[\"apikey\"] = \"REPLACE_KEY_VALUE\"\nrequest.body = JSON.dump({\n \"simpleUpdate\": \"True\",\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"truckNumber\": \"\",\n \"trailerNumber\": \"\"\n },\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"Parcel\"\n }\n },\n \"load\": {\n \"carrier\": \"cc79\",\n \"haulType\": [\n \"outbound_load\"\n ],\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"masterSequenceNumber\": nil,\n \"simultaneousTrackingSequenceNumber\": 1,\n \"trackingNumber\": \"1122334455\",\n \"loadNumber\": \"TestParcelUpdate\",\n \"priority\": \"normal\",\n \"referenceNumbers\": [\n \"LID:3454353,43534535\",\n \"BOL:5343,764345\",\n \"TMSID:L23432\",\n \"L34535\",\n \"SCAC:SER1\"\n ],\n \"relayLoad\": false,\n \"stops\": [\n {\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Suite 3300\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"name\": \"FourKites HQ\",\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 1,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D43\",\n \"stopType\": \"pickup\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": true,\n \"customer\": {\n \"id\": nil,\n \"poNumbers\": [\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"xyz@fourkites.com\",\n \"phone\": \"545454\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"earliestWantTime\": \"2024-04-21T16:31:29\",\n \"latestWantTime\": \"2024-04-21T16:31:29\",\n \"pallets\": [\n {\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125,\n \"freightCost\": 10,\n \"bestBeforeDate\": \"2024-04-25T00:00:00Z\",\n \"additionalCharges\": 5,\n \"tariffCost\": 2.5,\n \"fourKitesCalculatedTariffCost\": 2.5,\n \"totalLandedCost\": 132.5,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D43\",\n \"handlingUnitId\": \"1KYGQ\",\n \"barcode\": \"1KYGQ\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678905\",\n \"customerPartNumber\": \"1KYGQ\",\n \"supplierPartNumber\": \"1KYGQ\",\n \"manufacturerPartNumber\": \"MFG-1KYGQ\",\n \"itemNumber\": \"ITM-1KYGQ\",\n \"productUpc\": \"012345678905\",\n \"deliveryReferences\": [\n \"BOL:43489495\"\n ],\n \"orderReferences\": [\n \"SO:G024307300\"\n ],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGQ\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"RFID_TAG\"\n }\n ]\n },\n {\n \"addressLine1\": \"425 South Palos Verdes Street\",\n \"addressLine2\": \"\",\n \"city\": \"Los Angeles\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": 1453242,\n \"poNumbers\": [\n \"04112024\",\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"abc@fourkites.com\",\n \"phone\": \"1234456734\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"earliestWantTime\": \"2024-04-22T16:31:29\",\n \"latestWantTime\": \"2024-04-22T16:31:29\",\n \"name\": \"Hammond, LA DC\",\n \"pallets\": [\n {\n \"billOfLading\": 43489495,\n \"number\": \"00001\",\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"postalCode\": \"70401\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 2,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D41\",\n \"stopType\": \"delivery\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": true,\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125,\n \"freightCost\": 10,\n \"additionalCharges\": 5,\n \"tariffCost\": 2.5,\n \"fourKitesCalculatedTariffCost\": 2.5,\n \"totalLandedCost\": 132.5,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D41\",\n \"handlingUnitId\": \"00001\",\n \"barcode\": \"1KYGR\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678912\",\n \"customerPartNumber\": \"1KYGR\",\n \"supplierPartNumber\": \"1KYGR\",\n \"manufacturerPartNumber\": \"MFG-1KYGR\",\n \"itemNumber\": \"ITM-1KYGR\",\n \"productUpc\": \"012345678912\",\n \"deliveryReferences\": [\n \"BOL:43489495\"\n ],\n \"orderReferences\": [\n \"SO:G024307300\"\n ],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGR\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"QR_CODE\"\n }\n ]\n }\n ]\n }\n})\n\nresponse = https.request(request)\nputs response.read_body\n", "customLabel": "" }, { "id": "rUTBIPR4eat_H8Raawgsv", "language": "python", "code": "import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.fourkites.com\")\npayload = json.dumps({\n \"simpleUpdate\": \"True\",\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"truckNumber\": \"\",\n \"trailerNumber\": \"\"\n },\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"Parcel\"\n }\n },\n \"load\": {\n \"carrier\": \"cc79\",\n \"haulType\": [\n \"outbound_load\"\n ],\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"masterSequenceNumber\": None,\n \"simultaneousTrackingSequenceNumber\": 1,\n \"trackingNumber\": \"1122334455\",\n \"loadNumber\": \"TestParcelUpdate\",\n \"priority\": \"normal\",\n \"referenceNumbers\": [\n \"LID:3454353,43534535\",\n \"BOL:5343,764345\",\n \"TMSID:L23432\",\n \"L34535\",\n \"SCAC:SER1\"\n ],\n \"relayLoad\": False,\n \"stops\": [\n {\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Suite 3300\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"name\": \"FourKites HQ\",\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 1,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D43\",\n \"stopType\": \"pickup\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": True,\n \"customer\": {\n \"id\": None,\n \"poNumbers\": [\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"xyz@fourkites.com\",\n \"phone\": \"545454\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"earliestWantTime\": \"2024-04-21T16:31:29\",\n \"latestWantTime\": \"2024-04-21T16:31:29\",\n \"pallets\": [\n {\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125,\n \"freightCost\": 10,\n \"bestBeforeDate\": \"2024-04-25T00:00:00Z\",\n \"additionalCharges\": 5,\n \"tariffCost\": 2.5,\n \"fourKitesCalculatedTariffCost\": 2.5,\n \"totalLandedCost\": 132.5,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D43\",\n \"handlingUnitId\": \"1KYGQ\",\n \"barcode\": \"1KYGQ\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678905\",\n \"customerPartNumber\": \"1KYGQ\",\n \"supplierPartNumber\": \"1KYGQ\",\n \"manufacturerPartNumber\": \"MFG-1KYGQ\",\n \"itemNumber\": \"ITM-1KYGQ\",\n \"productUpc\": \"012345678905\",\n \"deliveryReferences\": [\n \"BOL:43489495\"\n ],\n \"orderReferences\": [\n \"SO:G024307300\"\n ],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGQ\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"RFID_TAG\"\n }\n ]\n },\n {\n \"addressLine1\": \"425 South Palos Verdes Street\",\n \"addressLine2\": \"\",\n \"city\": \"Los Angeles\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": 1453242,\n \"poNumbers\": [\n \"04112024\",\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"abc@fourkites.com\",\n \"phone\": \"1234456734\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"earliestWantTime\": \"2024-04-22T16:31:29\",\n \"latestWantTime\": \"2024-04-22T16:31:29\",\n \"name\": \"Hammond, LA DC\",\n \"pallets\": [\n {\n \"billOfLading\": 43489495,\n \"number\": \"00001\",\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"postalCode\": \"70401\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 2,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D41\",\n \"stopType\": \"delivery\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": True,\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125,\n \"freightCost\": 10,\n \"additionalCharges\": 5,\n \"tariffCost\": 2.5,\n \"fourKitesCalculatedTariffCost\": 2.5,\n \"totalLandedCost\": 132.5,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D41\",\n \"handlingUnitId\": \"00001\",\n \"barcode\": \"1KYGR\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678912\",\n \"customerPartNumber\": \"1KYGR\",\n \"supplierPartNumber\": \"1KYGR\",\n \"manufacturerPartNumber\": \"MFG-1KYGR\",\n \"itemNumber\": \"ITM-1KYGR\",\n \"productUpc\": \"012345678912\",\n \"deliveryReferences\": [\n \"BOL:43489495\"\n ],\n \"orderReferences\": [\n \"SO:G024307300\"\n ],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGR\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"QR_CODE\"\n }\n ]\n }\n ]\n }\n})\nheaders = {\n 'Content-Type': 'application/json',\n 'apikey': 'REPLACE_KEY_VALUE'\n}\nconn.request(\"PATCH\", \"/api/v1/tracking/417537760\", payload, headers)\nres = conn.getresponse()\ndata = res.read()\nprint(data.decode(\"utf-8\"))", "customLabel": "" } ], "selectedLanguageId": "rUTBIPR4eat_H8Raawgsv" }, "results": { "languages": [ { "id": "gmDgZ35TuXHqAL2aXteyy", "language": "200", "customLabel": "", "code": "{\n \"message\": \"Load updated successfully\",\n \"requestId\": \"cojn90c6o9momjnsuam0\",\n \"statusCode\": 200\n}" } ], "selectedLanguageId": "gmDgZ35TuXHqAL2aXteyy" }, "request": { "pathParameters": [], "queryParameters": [], "headerParameters": [], "bodyDataParameters": [ { "name": "simpleUpdate", "kind": "optional", "type": "boolean", "description": "Indicates whether the load object in the request payload is the complete snapshot of the load to be updated. Default to false. Valid values: true or false.", "": "boolean" }, { "name": "trackingInfo", "kind": "optional", "type": "object", "description": "It indicates the information required for tracking the load.", "children": [ { "name": "driverPhone", "kind": "optional", "type": "string", "description": "Enter the phone number of the driver currently assigned to the load. The phone number must start with a \"+\" sign followed by the country code, area code, and then the mobile number.\n\nFor example, in Brazil, the country code is +55, followed by the area code 19, and then the driver's phone number.\n\n+5519999999999\n\nSimilarly, in the USA, the country code is +1, followed by the 10-digit driver phone number.\n\n+19087654321\n\nThe only exception is when a US user is updating a US phone number, in which case they can enter the number as a 10-digit string (e.g., \"9087654321\")." }, { "name": "truckNumber", "kind": "optional", "type": "string", "description": "It indicates the tractor or asset number dispatched by the carrier for the load." }, { "name": "trailerNumber", "kind": "optional", "type": "string", "description": "It indicates the trailer number assigned to the load." } ] }, { "name": "modeDetails", "kind": "optional", "type": "string", "description": "It defines the mode of the load. Valid values: \"Parcel\"" }, { "name": "load", "kind": "required", "type": "object", "description": "It is the parent object for the load. Place the load attributes inside this object.", "children": [ { "name": "carrier", "kind": "required", "type": "string", "description": "It is the SCAC or Service Provider ID of the carrier assigned to the load. The carrier should have approved sharing of their telematics data on FourKites® for the customer." }, { "name": "haulType", "kind": "optional", "type": "array", "description": "It indicates whether the load is an inbound or an outbound load. Valid values: \"inbound_load\", \"outbound_load\", \"short_haul\", \"round_trip\", \"brokered_load\", \"non-brokered_load\", \"inbound_load\", \"outbound_load\", travel_ban_warnings\"" }, { "name": "simultaneousTrackingReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of simultaneous loads in order to group them. For example, simultaneousTrackingReferenceNumber: “E900018290”" }, { "name": "masterSequenceNumber", "kind": "optional", "type": "string", "description": "It is the unique sequence number that represents the leg of the trip used for Consignment Pooling." }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It indicates the small parcel tracking number used for the load." }, { "name": "loadNumber", "kind": "required", "type": "string", "description": "It is the unique load identifier from shipper's system. The load Number or BOL is an important piece of information used to link the load with truck information received from the Carrier's TMS." }, { "name": "priority", "kind": "optional", "type": "string", "description": "It indicates whether a load is of normal or high priority. If priority is set as ‘hot’, the load will be marked as ‘Hot’. Valid values: ‘normal’, ‘high’ and ‘hot’. Defaults to normal. Setting the 'Priority' as 'hot' will mark the load as 'Hot' load." }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It is the list of load-level reference numbers associated with a load. (CM)" }, { "name": "relayLoad", "kind": "optional", "type": "boolean", "description": "It indicates whether the load is relay or team load. \tValid values: true or false. Defaults to false. (CM)" }, { "name": "stops", "kind": "required", "type": "object", "description": "It is the list of stops for the load.", "children": [ { "name": "addressLine1", "kind": "required", "type": "string", "description": "It indicates the first line of the stop's address." }, { "name": "addressLine2", "kind": "optional", "type": "string", "description": "It indicates the second line of the stop's address." }, { "name": "city", "kind": "required", "type": "string", "description": "It indicates the name of the city. \tWhen we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now we have a restriction to pass state name when the stop doesn't have external AddressId and we match the port with only city & country." }, { "name": "country", "kind": "optional", "type": "string", "description": "It indicates the valid country code. It is the 2 digit country code. When we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now, we have a restriction to pass the state name when the stop doesn't have external AddressId and we want to match the port with only city & country." }, { "name": "name", "kind": "required", "type": "string", "description": "It is the name of the stop." }, { "name": "postalCode", "kind": "optional", "type": "string", "description": "It indicates the valid postal code for the stop." }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of stop level reference numbers associated with the stop. These are searchable within the FourKites platform. (CM)" }, { "name": "sequence", "kind": "optional", "type": "string", "description": "It indicates the stop's sequence on a load. The lower value indicates earliest scheduled stop completion. If the stop sequence is present for one stop on a load, it must be present on all stops. It is recommended to start at 1 and increment by 1 for each additional stop. (CM)" }, { "name": "state", "kind": "required", "type": "string", "description": "It indicates the 2 character state code for US & Canada and 3 Character state code for Mexico. It is the 2 character State Code for US & Canada and 3 Character State Code for Mexico." }, { "name": "stopReferenceId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the stop from the customer's system. This populates the \"Reference #\" field on the stop and is used to indicate which stop an update is applied to. (CM)" }, { "name": "stopType", "kind": "required", "type": "string", "description": "It defines the function of the stop. Valid values: \"pickup\", \"delivery\", \"transfer\", \"portOfLoading\", \"transshipmentPort\", \"portOfDischarge\". There should be at least one pickup and delivery stop or one transfer (terminal) and one delivery." }, { "name": "unloadTimeInMinutes", "kind": "optional", "type": "string", "description": "It indicates the dwell time to be used for the stop in ETA calculations (in minutes). When it is not provided, the company level default value will be used, if available or 90 minutes. This value must be sent in minutes." }, { "name": "productLineItems", "kind": "optional", "type": "object", "description": "It is the list of product level details associated with a stop. Replaces the legacy pallets/parts structure going forward.", "children": [ { "name": "productId", "kind": "required", "type": "string", "description": "Unique identifier for the product. Mandatory if productLineItems object is present" }, { "name": "productName", "kind": "optional", "type": "string", "description": "Name of the product" }, { "name": "productDescription", "kind": "optional", "type": "string", "description": "Detailed description of the product" }, { "name": "productCategory", "kind": "optional", "type": "string", "description": "Category classification of the product" }, { "name": "quantity", "kind": "optional", "type": "integer", "description": "Number of units in the shipment" }, { "name": "measurementUnitCode", "kind": "optional", "type": "string", "description": "Unit of measurement for quantity (e.g., PCE, KG, LB)" }, { "name": "netWeight", "kind": "optional", "type": "string", "description": "Weight of the product excluding packaging" }, { "name": "weightUnit", "kind": "optional", "type": "string", "description": "Unit of measurement for weight (e.g., KGM, LBM)" }, { "name": "unitCost", "kind": "optional", "type": "number", "description": "Cost per unit of the product" }, { "name": "currencyCode", "kind": "optional", "type": "string", "description": "Currency code for cost fields" }, { "name": "extendedCost", "kind": "optional", "type": "number", "description": "Total cost for all units (unitCost x quantity)" }, { "name": "freightCost", "kind": "optional", "type": "number", "description": "Freight cost allocated to this line item" }, { "name": "bestBeforeDate", "kind": "optional", "type": "string", "description": "Expiration or best before date for the product" }, { "name": "additionalCharges", "kind": "optional", "type": "number", "description": "Any additional charges specific to this line item" }, { "name": "tariffCost", "kind": "optional", "type": "number", "description": "Tariff cost for this specific line item" }, { "name": "fourKitesCalculatedTariffCost", "kind": "optional", "type": "number", "description": "System-calculated tariff cost" }, { "name": "totalLandedCost", "kind": "optional", "type": "number", "description": "Total landed cost for this line item" }, { "name": "countryOfOrigin", "kind": "optional", "type": "string", "description": "Country of origin for this product" }, { "name": "harmonizedSystemCode", "kind": "optional", "type": "string", "description": "International trade classification code" }, { "name": "commodityTypeCode", "kind": "optional", "type": "string", "description": "Commodity classification code" }, { "name": "htsusCode", "kind": "optional", "type": "string", "description": "Harmonized Tariff Schedule code for US imports" }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "Purchase order number" }, { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Delivery reference number" }, { "name": "handlingUnitId", "kind": "optional", "type": "string", "description": "Identifier for the handling unit (pallet, box, etc.)" }, { "name": "barcode", "kind": "optional", "type": "string", "description": "Product barcode" }, { "name": "containerType", "kind": "optional", "type": "string", "description": "Type of container (pallet, box, carton, etc.)" }, { "name": "gtin", "kind": "optional", "type": "string", "description": "Global Trade Item Number" }, { "name": "customerPartNumber", "kind": "optional", "type": "string", "description": "Customer's part number for the product" }, { "name": "supplierPartNumber", "kind": "optional", "type": "string", "description": "Supplier's part number for the product" }, { "name": "manufacturerPartNumber", "kind": "optional", "type": "string", "description": "Manufacturer's part number" }, { "name": "itemNumber", "kind": "optional", "type": "string", "description": "Internal item number" }, { "name": "productUpc", "kind": "optional", "type": "string", "description": "Universal Product Code" }, { "name": "deliveryReferences", "kind": "optional", "type": "string", "description": "Array of delivery reference numbers" }, { "name": "orderReferences", "kind": "optional", "type": "string", "description": "Array of order reference numbers" }, { "name": "brandName", "kind": "optional", "type": "string", "description": "Brand name of the product" }, { "name": "minimumTemperature", "kind": "optional", "type": "integer", "description": "Minimum storage/transport temperature" }, { "name": "maximumTemperature", "kind": "optional", "type": "integer", "description": "Maximum storage/transport temperature" }, { "name": "temperatureUnitCode", "kind": "optional", "type": "string", "description": "Temperature unit (cel, fah)" }, { "name": "labelIdentifier", "kind": "optional", "type": "string", "description": "Label identifier for tracking" }, { "name": "productTrackingNumber", "kind": "optional", "type": "string", "description": "Unique tracking number for the product" }, { "name": "deviceType", "kind": "optional", "type": "string", "description": "Type of tracking device (RFID_TAG, QR_CODE, etc.)" } ] }, { "name": "timeInUtc", "kind": "optional", "type": "boolean", "description": "Indicates whether the appointment times sent in the message are in UTC. By default, FourKites assumes the times are in the local time of the stop" }, { "name": "customer", "kind": "optional", "type": "object", "description": "It indicates the customer information for the stop. (CM)", "children": [ { "name": "id", "kind": "optional", "type": "string", "description": "It is the unique identifier of the shipper's customer. The customer should have been created in FourKites before associating it to a load's stop. (CM)" }, { "name": "poNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of Customer PO Numbers associated with the load's stop. (CM)" }, { "name": "pointOfContact", "kind": "optional", "type": "object", "description": "It indicates the point of contact (POC) information at the stop, capturing name, email, phone number, and whether they should be alerted. You can send up to 5 POCs objects per stop.", "children": [ { "name": "email", "kind": "optional", "type": "string", "description": "It indicates the email address of the point of contact at the stop." }, { "name": "phone", "kind": "optional", "type": "string", "description": "It indicates the phone number of the point of contact at the stop. The ISD code followed by mobile number prepended with \"+\" and no special characters." } ] } ] }, { "name": "earliestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the earliest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the earliestAppointmentTime is sent, then the latestAppointmentTime must also be sent.\n\nTo maintain existing data during an In-Transit Load Update, you must exclude the specific field from your payload entirely. Including a field with a null value is interpreted as an intentional command to clear or delete the current information. This distinction is critical for appointment windows; passing null will collapse a time range by stripping the stored values." }, { "name": "latestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the latest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the latestAppointmentTime is sent, then the earliestAppointmentTime must also be sent. latestAppointmentTime should be greater than or equal to earliestAppointmentTime.\n\nTo maintain existing data during an In-Transit Load Update, you must exclude the specific field from your payload entirely. Including a field with a null value is interpreted as an intentional command to clear or delete the current information. This distinction is critical for appointment windows; passing null will collapse a time range by stripping the stored values." }, { "name": "earliestWantTime", "kind": "optional", "type": "string", "description": "It indicates the earliest time by which the load must be delivered to the consignee in the stop's local timezone in ISO 8601 format. (CM)" }, { "name": "latestWantTime", "kind": "optional", "type": "string", "description": "It indicates the latest time by which the load must be delivered to the consignee in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the latestWantTime is sent, then the earliestWantTime must also be sent. (CM)" }, { "name": "pallets", "kind": "optional", "type": "object", "description": "It indicates the list of pallets to be delivered at the stop. Each pallet has a pallet number and list of parts.", "children": [ { "name": "parts", "kind": "optional", "type": "object", "description": "It indicates the list of parts in the pallet.", "children": [ { "name": "quantity", "kind": "optional", "type": "string", "description": "It indicates the quantity of the part." }, { "name": "shipperPartNumber", "kind": "optional", "type": "string", "description": "It indicates the shipper/manufacturer’s part number." }, { "name": "weight", "kind": "optional", "type": "string", "description": "It indicates the weight of the part." } ] } ] } ] } ], "schema": [ { "name": "carrier", "kind": "required", "type": "string", "description": "It is the SCAC or Service Provider ID of the carrier assigned to the load. The carrier should have approved sharing of their telematics data on FourKites® for the customer." }, { "name": "haulType", "kind": "optional", "type": "array", "description": "It indicates whether the load is an inbound or an outbound load. Valid values: \"inbound_load\", \"outbound_load\", \"short_haul\", \"round_trip\", \"brokered_load\", \"non-brokered_load\", \"inbound_load\", \"outbound_load\", travel_ban_warnings\"" }, { "name": "simultaneousTrackingReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of simultaneous loads in order to group them. For example, simultaneousTrackingReferenceNumber: “E900018290”" }, { "name": "masterSequenceNumber", "kind": "optional", "type": "string", "description": "It is the unique sequence number that represents the leg of the trip used for Consignment Pooling." }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It indicates the small parcel tracking number used for the load." }, { "name": "loadNumber", "kind": "required", "type": "string", "description": "It is the unique load identifier from shipper's system. The load Number or BOL is an important piece of information used to link the load with truck information received from the Carrier's TMS." }, { "name": "priority", "kind": "optional", "type": "string", "description": "It indicates whether a load is of normal or high priority. If priority is set as ‘hot’, the load will be marked as ‘Hot’. Valid values: ‘normal’, ‘high’ and ‘hot’. Defaults to normal. Setting the 'Priority' as 'hot' will mark the load as 'Hot' load." }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It is the list of load-level reference numbers associated with a load. (CM)" }, { "name": "relayLoad", "kind": "optional", "type": "boolean", "description": "It indicates whether the load is relay or team load. \tValid values: true or false. Defaults to false. (CM)" }, { "name": "stops", "kind": "required", "type": "object", "description": "It is the list of stops for the load.", "children": [ { "name": "addressLine1", "kind": "required", "type": "string", "description": "It indicates the first line of the stop's address." }, { "name": "addressLine2", "kind": "optional", "type": "string", "description": "It indicates the second line of the stop's address." }, { "name": "city", "kind": "required", "type": "string", "description": "It indicates the name of the city. \tWhen we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now we have a restriction to pass state name when the stop doesn't have external AddressId and we match the port with only city & country." }, { "name": "country", "kind": "optional", "type": "string", "description": "It indicates the valid country code. It is the 2 digit country code. When we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now, we have a restriction to pass the state name when the stop doesn't have external AddressId and we want to match the port with only city & country." }, { "name": "name", "kind": "required", "type": "string", "description": "It is the name of the stop." }, { "name": "postalCode", "kind": "optional", "type": "string", "description": "It indicates the valid postal code for the stop." }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of stop level reference numbers associated with the stop. These are searchable within the FourKites platform. (CM)" }, { "name": "sequence", "kind": "optional", "type": "string", "description": "It indicates the stop's sequence on a load. The lower value indicates earliest scheduled stop completion. If the stop sequence is present for one stop on a load, it must be present on all stops. It is recommended to start at 1 and increment by 1 for each additional stop. (CM)" }, { "name": "state", "kind": "required", "type": "string", "description": "It indicates the 2 character state code for US & Canada and 3 Character state code for Mexico. It is the 2 character State Code for US & Canada and 3 Character State Code for Mexico." }, { "name": "stopReferenceId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the stop from the customer's system. This populates the \"Reference #\" field on the stop and is used to indicate which stop an update is applied to. (CM)" }, { "name": "stopType", "kind": "required", "type": "string", "description": "It defines the function of the stop. Valid values: \"pickup\", \"delivery\", \"transfer\", \"portOfLoading\", \"transshipmentPort\", \"portOfDischarge\". There should be at least one pickup and delivery stop or one transfer (terminal) and one delivery." }, { "name": "unloadTimeInMinutes", "kind": "optional", "type": "string", "description": "It indicates the dwell time to be used for the stop in ETA calculations (in minutes). When it is not provided, the company level default value will be used, if available or 90 minutes. This value must be sent in minutes." }, { "name": "productLineItems", "kind": "optional", "type": "object", "description": "It is the list of product level details associated with a stop. Replaces the legacy pallets/parts structure going forward.", "children": [ { "name": "productId", "kind": "required", "type": "string", "description": "Unique identifier for the product. Mandatory if productLineItems object is present" }, { "name": "productName", "kind": "optional", "type": "string", "description": "Name of the product" }, { "name": "productDescription", "kind": "optional", "type": "string", "description": "Detailed description of the product" }, { "name": "productCategory", "kind": "optional", "type": "string", "description": "Category classification of the product" }, { "name": "quantity", "kind": "optional", "type": "integer", "description": "Number of units in the shipment" }, { "name": "measurementUnitCode", "kind": "optional", "type": "string", "description": "Unit of measurement for quantity (e.g., PCE, KG, LB)" }, { "name": "netWeight", "kind": "optional", "type": "string", "description": "Weight of the product excluding packaging" }, { "name": "weightUnit", "kind": "optional", "type": "string", "description": "Unit of measurement for weight (e.g., KGM, LBM)" }, { "name": "unitCost", "kind": "optional", "type": "number", "description": "Cost per unit of the product" }, { "name": "currencyCode", "kind": "optional", "type": "string", "description": "Currency code for cost fields" }, { "name": "extendedCost", "kind": "optional", "type": "number", "description": "Total cost for all units (unitCost x quantity)" }, { "name": "freightCost", "kind": "optional", "type": "number", "description": "Freight cost allocated to this line item" }, { "name": "bestBeforeDate", "kind": "optional", "type": "string", "description": "Expiration or best before date for the product" }, { "name": "additionalCharges", "kind": "optional", "type": "number", "description": "Any additional charges specific to this line item" }, { "name": "tariffCost", "kind": "optional", "type": "number", "description": "Tariff cost for this specific line item" }, { "name": "fourKitesCalculatedTariffCost", "kind": "optional", "type": "number", "description": "System-calculated tariff cost" }, { "name": "totalLandedCost", "kind": "optional", "type": "number", "description": "Total landed cost for this line item" }, { "name": "countryOfOrigin", "kind": "optional", "type": "string", "description": "Country of origin for this product" }, { "name": "harmonizedSystemCode", "kind": "optional", "type": "string", "description": "International trade classification code" }, { "name": "commodityTypeCode", "kind": "optional", "type": "string", "description": "Commodity classification code" }, { "name": "htsusCode", "kind": "optional", "type": "string", "description": "Harmonized Tariff Schedule code for US imports" }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "Purchase order number" }, { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Delivery reference number" }, { "name": "handlingUnitId", "kind": "optional", "type": "string", "description": "Identifier for the handling unit (pallet, box, etc.)" }, { "name": "barcode", "kind": "optional", "type": "string", "description": "Product barcode" }, { "name": "containerType", "kind": "optional", "type": "string", "description": "Type of container (pallet, box, carton, etc.)" }, { "name": "gtin", "kind": "optional", "type": "string", "description": "Global Trade Item Number" }, { "name": "customerPartNumber", "kind": "optional", "type": "string", "description": "Customer's part number for the product" }, { "name": "supplierPartNumber", "kind": "optional", "type": "string", "description": "Supplier's part number for the product" }, { "name": "manufacturerPartNumber", "kind": "optional", "type": "string", "description": "Manufacturer's part number" }, { "name": "itemNumber", "kind": "optional", "type": "string", "description": "Internal item number" }, { "name": "productUpc", "kind": "optional", "type": "string", "description": "Universal Product Code" }, { "name": "deliveryReferences", "kind": "optional", "type": "string", "description": "Array of delivery reference numbers" }, { "name": "orderReferences", "kind": "optional", "type": "string", "description": "Array of order reference numbers" }, { "name": "brandName", "kind": "optional", "type": "string", "description": "Brand name of the product" }, { "name": "minimumTemperature", "kind": "optional", "type": "integer", "description": "Minimum storage/transport temperature" }, { "name": "maximumTemperature", "kind": "optional", "type": "integer", "description": "Maximum storage/transport temperature" }, { "name": "temperatureUnitCode", "kind": "optional", "type": "string", "description": "Temperature unit (cel, fah)" }, { "name": "labelIdentifier", "kind": "optional", "type": "string", "description": "Label identifier for tracking" }, { "name": "productTrackingNumber", "kind": "optional", "type": "string", "description": "Unique tracking number for the product" }, { "name": "deviceType", "kind": "optional", "type": "string", "description": "Type of tracking device (RFID_TAG, QR_CODE, etc.)" } ] }, { "name": "timeInUtc", "kind": "optional", "type": "boolean", "description": "Indicates whether the appointment times sent in the message are in UTC. By default, FourKites assumes the times are in the local time of the stop" }, { "name": "customer", "kind": "optional", "type": "object", "description": "It indicates the customer information for the stop. (CM)", "children": [ { "name": "id", "kind": "optional", "type": "string", "description": "It is the unique identifier of the shipper's customer. The customer should have been created in FourKites before associating it to a load's stop. (CM)" }, { "name": "poNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of Customer PO Numbers associated with the load's stop. (CM)" }, { "name": "pointOfContact", "kind": "optional", "type": "object", "description": "It indicates the point of contact (POC) information at the stop, capturing name, email, phone number, and whether they should be alerted. You can send up to 5 POCs objects per stop.", "children": [ { "name": "email", "kind": "optional", "type": "string", "description": "It indicates the email address of the point of contact at the stop." }, { "name": "phone", "kind": "optional", "type": "string", "description": "It indicates the phone number of the point of contact at the stop. The ISD code followed by mobile number prepended with \"+\" and no special characters." } ] } ] }, { "name": "earliestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the earliest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the earliestAppointmentTime is sent, then the latestAppointmentTime must also be sent.\n\nTo maintain existing data during an In-Transit Load Update, you must exclude the specific field from your payload entirely. Including a field with a null value is interpreted as an intentional command to clear or delete the current information. This distinction is critical for appointment windows; passing null will collapse a time range by stripping the stored values." }, { "name": "latestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the latest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the latestAppointmentTime is sent, then the earliestAppointmentTime must also be sent. latestAppointmentTime should be greater than or equal to earliestAppointmentTime.\n\nTo maintain existing data during an In-Transit Load Update, you must exclude the specific field from your payload entirely. Including a field with a null value is interpreted as an intentional command to clear or delete the current information. This distinction is critical for appointment windows; passing null will collapse a time range by stripping the stored values." }, { "name": "earliestWantTime", "kind": "optional", "type": "string", "description": "It indicates the earliest time by which the load must be delivered to the consignee in the stop's local timezone in ISO 8601 format. (CM)" }, { "name": "latestWantTime", "kind": "optional", "type": "string", "description": "It indicates the latest time by which the load must be delivered to the consignee in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the latestWantTime is sent, then the earliestWantTime must also be sent. (CM)" }, { "name": "pallets", "kind": "optional", "type": "object", "description": "It indicates the list of pallets to be delivered at the stop. Each pallet has a pallet number and list of parts.", "children": [ { "name": "parts", "kind": "optional", "type": "object", "description": "It indicates the list of parts in the pallet.", "children": [ { "name": "quantity", "kind": "optional", "type": "string", "description": "It indicates the quantity of the part." }, { "name": "shipperPartNumber", "kind": "optional", "type": "string", "description": "It indicates the shipper/manufacturer’s part number." }, { "name": "weight", "kind": "optional", "type": "string", "description": "It indicates the weight of the part." } ] } ] } ] } ] } ], "formDataParameters": [] }, "currentNewParameter": { "label": "Body Parameter", "value": "bodyDataParameters" }, "hasTryItOut": false, "autoGeneratedAnchorSlug": "production", "legacyHash": "_ZNmhmEbX5GLIOlyYj61m" } ``` ::: :::ApiMethodV2 ```json { "name": "Staging", "method": "PATCH", "url": "https://api-staging.fourkites.com/api/v1/tracking/417537760", "description": "", "tab": "examples", "examples": { "languages": [ { "id": "wR1OWhW9o2iM2rrEKy6Cw", "language": "curl", "code": "curl --location --request PATCH 'https://api-staging.fourkites.com/api/v1/tracking/417537760' \\\n--header 'Content-Type: application/json' \\\n--header 'apikey: REPLACE_KEY_VALUE' \\\n--data-raw '{\n \"simpleUpdate\": \"True\",\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"truckNumber\": \"\",\n \"trailerNumber\": \"\"\n },\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"Parcel\"\n }\n },\n \"load\": {\n \"carrier\": \"cc79\",\n \"haulType\": [\n \"outbound_load\"\n ],\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"masterSequenceNumber\": null,\n \"simultaneousTrackingSequenceNumber\": 1,\n \"trackingNumber\": \"1122334455\",\n \"loadNumber\": \"TestParcelUpdate\",\n \"priority\": \"normal\",\n \"referenceNumbers\": [\n \"LID:3454353,43534535\",\n \"BOL:5343,764345\",\n \"TMSID:L23432\",\n \"L34535\",\n \"SCAC:SER1\"\n ],\n \"relayLoad\": false,\n \"stops\": [\n {\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Suite 3300\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"name\": \"FourKites HQ\",\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 1,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D43\",\n \"stopType\": \"pickup\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": true,\n \"customer\": {\n \"id\": null,\n \"poNumbers\": [\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"xyz@fourkites.com\",\n \"phone\": \"545454\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"earliestWantTime\": \"2024-04-21T16:31:29\",\n \"latestWantTime\": \"2024-04-21T16:31:29\",\n \"pallets\": [\n {\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25.0,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125.00,\n \"freightCost\": 10.00,\n \"bestBeforeDate\": \"2024-04-25T00:00:00Z\",\n \"additionalCharges\": 5.00,\n \"tariffCost\": 2.50,\n \"fourKitesCalculatedTariffCost\": 2.50,\n \"totalLandedCost\": 132.50,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D43\",\n \"handlingUnitId\": \"1KYGQ\",\n \"barcode\": \"1KYGQ\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678905\",\n \"customerPartNumber\": \"1KYGQ\",\n \"supplierPartNumber\": \"1KYGQ\",\n \"manufacturerPartNumber\": \"MFG-1KYGQ\",\n \"itemNumber\": \"ITM-1KYGQ\",\n \"productUpc\": \"012345678905\",\n \"deliveryReferences\": [\"BOL:43489495\"],\n \"orderReferences\": [\"SO:G024307300\"],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGQ\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"RFID_TAG\"\n }\n ]\n },\n {\n \"addressLine1\": \"425 South Palos Verdes Street\",\n \"addressLine2\": \"\",\n \"city\": \"Los Angeles\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": 1453242,\n \"poNumbers\": [\n \"04112024\",\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"abc@fourkites.com\",\n \"phone\": \"1234456734\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"earliestWantTime\": \"2024-04-22T16:31:29\",\n \"latestWantTime\": \"2024-04-22T16:31:29\",\n \"name\": \"Hammond, LA DC\",\n \"pallets\": [\n {\n \"billOfLading\": 43489495,\n \"number\": \"00001\",\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"postalCode\": \"70401\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 2,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D41\",\n \"stopType\": \"delivery\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": true,\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25.0,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125.00,\n \"freightCost\": 10.00,\n \"additionalCharges\": 5.00,\n \"tariffCost\": 2.50,\n \"fourKitesCalculatedTariffCost\": 2.50,\n \"totalLandedCost\": 132.50,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D41\",\n \"handlingUnitId\": \"00001\",\n \"barcode\": \"1KYGR\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678912\",\n \"customerPartNumber\": \"1KYGR\",\n \"supplierPartNumber\": \"1KYGR\",\n \"manufacturerPartNumber\": \"MFG-1KYGR\",\n \"itemNumber\": \"ITM-1KYGR\",\n \"productUpc\": \"012345678912\",\n \"deliveryReferences\": [\"BOL:43489495\"],\n \"orderReferences\": [\"SO:G024307300\"],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGR\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"QR_CODE\"\n }\n ]\n }\n ]\n }\n}'", "customLabel": "" }, { "id": "HylwcpcCE9BW0gTLbtHLy", "language": "java", "code": "OkHttpClient client = new OkHttpClient().newBuilder()\n .build();\nMediaType mediaType = MediaType.parse(\"application/json\");\nRequestBody body = RequestBody.create(mediaType, \"{\\n \\\"simpleUpdate\\\": \\\"True\\\",\\n \\\"trackingInfo\\\": {\\n \\\"driverPhone\\\": \\\"\\\",\\n \\\"truckNumber\\\": \\\"\\\",\\n \\\"trailerNumber\\\": \\\"\\\"\\n },\\n \\\"additionalData\\\": {\\n \\\"modeDetails\\\": {\\n \\\"shipperModes\\\": \\\"Parcel\\\"\\n }\\n },\\n \\\"load\\\": {\\n \\\"carrier\\\": \\\"cc79\\\",\\n \\\"haulType\\\": [\\n \\\"outbound_load\\\"\\n ],\\n \\\"simultaneousTrackingReferenceNumber\\\": \\\"simul123\\\",\\n \\\"masterSequenceNumber\\\": null,\\n \\\"simultaneousTrackingSequenceNumber\\\": 1,\\n \\\"trackingNumber\\\": \\\"1122334455\\\",\\n \\\"loadNumber\\\": \\\"TestParcelUpdate\\\",\\n \\\"priority\\\": \\\"normal\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"LID:3454353,43534535\\\",\\n \\\"BOL:5343,764345\\\",\\n \\\"TMSID:L23432\\\",\\n \\\"L34535\\\",\\n \\\"SCAC:SER1\\\"\\n ],\\n \\\"relayLoad\\\": false,\\n \\\"stops\\\": [\\n {\\n \\\"addressLine1\\\": \\\"500 West Madison Street\\\",\\n \\\"addressLine2\\\": \\\"Suite 3300\\\",\\n \\\"city\\\": \\\"Chicago\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"name\\\": \\\"FourKites HQ\\\",\\n \\\"postalCode\\\": \\\"60611\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"STNR:D43\\\",\\n \\\"BOL:43489495\\\",\\n \\\"43489495\\\",\\n \\\"SO:G024307300\\\"\\n ],\\n \\\"sequence\\\": 1,\\n \\\"state\\\": \\\"LA\\\",\\n \\\"stopReferenceId\\\": \\\"D43\\\",\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"unloadTimeInMinutes\\\": 120,\\n \\\"timeInUtc\\\": true,\\n \\\"customer\\\": {\\n \\\"id\\\": null,\\n \\\"poNumbers\\\": [\\n \\\"04112024\\\"\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"email\\\": \\\"xyz@fourkites.com\\\",\\n \\\"phone\\\": \\\"545454\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2024-04-21T19:16:15\\\",\\n \\\"latestAppointmentTime\\\": \\\"2024-04-21T19:16:15\\\",\\n \\\"earliestWantTime\\\": \\\"2024-04-21T16:31:29\\\",\\n \\\"latestWantTime\\\": \\\"2024-04-21T16:31:29\\\",\\n \\\"pallets\\\": [\\n {\\n \\\"parts\\\": [\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"weight\\\": \\\"7.998\\\"\\n },\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGR\\\",\\n \\\"weight\\\": \\\"36.800\\\"\\n }\\n ]\\n }\\n ],\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"0123456\\\",\\n \\\"productName\\\": \\\"Parcel Item\\\",\\n \\\"productDescription\\\": \\\"Parcel shipment item\\\",\\n \\\"productCategory\\\": \\\"General Merchandise\\\",\\n \\\"quantity\\\": 5,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 44.8,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 25.0,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 125.00,\\n \\\"freightCost\\\": 10.00,\\n \\\"bestBeforeDate\\\": \\\"2024-04-25T00:00:00Z\\\",\\n \\\"additionalCharges\\\": 5.00,\\n \\\"tariffCost\\\": 2.50,\\n \\\"fourKitesCalculatedTariffCost\\\": 2.50,\\n \\\"totalLandedCost\\\": 132.50,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"4819500000\\\",\\n \\\"commodityTypeCode\\\": \\\"GENERAL_MERCHANDISE\\\",\\n \\\"htsusCode\\\": \\\"4819500000\\\",\\n \\\"orderNumber\\\": \\\"04112024\\\",\\n \\\"deliveryNumber\\\": \\\"DN-D43\\\",\\n \\\"handlingUnitId\\\": \\\"1KYGQ\\\",\\n \\\"barcode\\\": \\\"1KYGQ\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"00012345678905\\\",\\n \\\"customerPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"supplierPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-1KYGQ\\\",\\n \\\"itemNumber\\\": \\\"ITM-1KYGQ\\\",\\n \\\"productUpc\\\": \\\"012345678905\\\",\\n \\\"deliveryReferences\\\": [\\\"BOL:43489495\\\"],\\n \\\"orderReferences\\\": [\\\"SO:G024307300\\\"],\\n \\\"brandName\\\": \\\"Generic Merchandise Co\\\",\\n \\\"minimumTemperature\\\": 0,\\n \\\"maximumTemperature\\\": 0,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-1KYGQ\\\",\\n \\\"productTrackingNumber\\\": \\\"1122334455\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n }\\n ]\\n },\\n {\\n \\\"addressLine1\\\": \\\"425 South Palos Verdes Street\\\",\\n \\\"addressLine2\\\": \\\"\\\",\\n \\\"city\\\": \\\"Los Angeles\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": 1453242,\\n \\\"poNumbers\\\": [\\n \\\"04112024\\\",\\n \\\"04112024\\\"\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"email\\\": \\\"abc@fourkites.com\\\",\\n \\\"phone\\\": \\\"1234456734\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2024-04-22T19:16:15\\\",\\n \\\"latestAppointmentTime\\\": \\\"2024-04-22T19:16:15\\\",\\n \\\"earliestWantTime\\\": \\\"2024-04-22T16:31:29\\\",\\n \\\"latestWantTime\\\": \\\"2024-04-22T16:31:29\\\",\\n \\\"name\\\": \\\"Hammond, LA DC\\\",\\n \\\"pallets\\\": [\\n {\\n \\\"billOfLading\\\": 43489495,\\n \\\"number\\\": \\\"00001\\\",\\n \\\"parts\\\": [\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"weight\\\": \\\"7.998\\\"\\n },\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGR\\\",\\n \\\"weight\\\": \\\"36.800\\\"\\n }\\n ]\\n }\\n ],\\n \\\"postalCode\\\": \\\"70401\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"STNR:D43\\\",\\n \\\"BOL:43489495\\\",\\n \\\"43489495\\\",\\n \\\"SO:G024307300\\\"\\n ],\\n \\\"sequence\\\": 2,\\n \\\"state\\\": \\\"LA\\\",\\n \\\"stopReferenceId\\\": \\\"D41\\\",\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"unloadTimeInMinutes\\\": 120,\\n \\\"timeInUtc\\\": true,\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"0123456\\\",\\n \\\"productName\\\": \\\"Parcel Item\\\",\\n \\\"productDescription\\\": \\\"Parcel shipment item\\\",\\n \\\"productCategory\\\": \\\"General Merchandise\\\",\\n \\\"quantity\\\": 5,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 44.8,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 25.0,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 125.00,\\n \\\"freightCost\\\": 10.00,\\n \\\"additionalCharges\\\": 5.00,\\n \\\"tariffCost\\\": 2.50,\\n \\\"fourKitesCalculatedTariffCost\\\": 2.50,\\n \\\"totalLandedCost\\\": 132.50,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"4819500000\\\",\\n \\\"commodityTypeCode\\\": \\\"GENERAL_MERCHANDISE\\\",\\n \\\"htsusCode\\\": \\\"4819500000\\\",\\n \\\"orderNumber\\\": \\\"04112024\\\",\\n \\\"deliveryNumber\\\": \\\"DN-D41\\\",\\n \\\"handlingUnitId\\\": \\\"00001\\\",\\n \\\"barcode\\\": \\\"1KYGR\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"00012345678912\\\",\\n \\\"customerPartNumber\\\": \\\"1KYGR\\\",\\n \\\"supplierPartNumber\\\": \\\"1KYGR\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-1KYGR\\\",\\n \\\"itemNumber\\\": \\\"ITM-1KYGR\\\",\\n \\\"productUpc\\\": \\\"012345678912\\\",\\n \\\"deliveryReferences\\\": [\\\"BOL:43489495\\\"],\\n \\\"orderReferences\\\": [\\\"SO:G024307300\\\"],\\n \\\"brandName\\\": \\\"Generic Merchandise Co\\\",\\n \\\"minimumTemperature\\\": 0,\\n \\\"maximumTemperature\\\": 0,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-1KYGR\\\",\\n \\\"productTrackingNumber\\\": \\\"1122334455\\\",\\n \\\"deviceType\\\": \\\"QR_CODE\\\"\\n }\\n ]\\n }\\n ]\\n }\\n}\");\nRequest request = new Request.Builder()\n .url(\"https://api-staging.fourkites.com/api/v1/tracking/417537760\")\n .method(\"PATCH\", body)\n .addHeader(\"Content-Type\", \"application/json\")\n .addHeader(\"apikey\", \"REPLACE_KEY_VALUE\")\n .build();\nResponse response = client.newCall(request).execute();", "customLabel": "" }, { "id": "fYOeDccneaOBAVR2bSIT3", "language": "javascript", "code": "var settings = {\n \"url\": \"https://api-staging.fourkites.com/api/v1/tracking/417537760\",\n \"method\": \"PATCH\",\n \"timeout\": 0,\n \"headers\": {\n \"Content-Type\": \"application/json\",\n \"apikey\": \"REPLACE_KEY_VALUE\"\n },\n \"data\": JSON.stringify({\n \"simpleUpdate\": \"True\",\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"truckNumber\": \"\",\n \"trailerNumber\": \"\"\n },\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"Parcel\"\n }\n },\n \"load\": {\n \"carrier\": \"cc79\",\n \"haulType\": [\n \"outbound_load\"\n ],\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"masterSequenceNumber\": null,\n \"simultaneousTrackingSequenceNumber\": 1,\n \"trackingNumber\": \"1122334455\",\n \"loadNumber\": \"TestParcelUpdate\",\n \"priority\": \"normal\",\n \"referenceNumbers\": [\n \"LID:3454353,43534535\",\n \"BOL:5343,764345\",\n \"TMSID:L23432\",\n \"L34535\",\n \"SCAC:SER1\"\n ],\n \"relayLoad\": false,\n \"stops\": [\n {\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Suite 3300\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"name\": \"FourKites HQ\",\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 1,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D43\",\n \"stopType\": \"pickup\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": true,\n \"customer\": {\n \"id\": null,\n \"poNumbers\": [\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"xyz@fourkites.com\",\n \"phone\": \"545454\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"earliestWantTime\": \"2024-04-21T16:31:29\",\n \"latestWantTime\": \"2024-04-21T16:31:29\",\n \"pallets\": [\n {\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125,\n \"freightCost\": 10,\n \"bestBeforeDate\": \"2024-04-25T00:00:00Z\",\n \"additionalCharges\": 5,\n \"tariffCost\": 2.5,\n \"fourKitesCalculatedTariffCost\": 2.5,\n \"totalLandedCost\": 132.5,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D43\",\n \"handlingUnitId\": \"1KYGQ\",\n \"barcode\": \"1KYGQ\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678905\",\n \"customerPartNumber\": \"1KYGQ\",\n \"supplierPartNumber\": \"1KYGQ\",\n \"manufacturerPartNumber\": \"MFG-1KYGQ\",\n \"itemNumber\": \"ITM-1KYGQ\",\n \"productUpc\": \"012345678905\",\n \"deliveryReferences\": [\n \"BOL:43489495\"\n ],\n \"orderReferences\": [\n \"SO:G024307300\"\n ],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGQ\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"RFID_TAG\"\n }\n ]\n },\n {\n \"addressLine1\": \"425 South Palos Verdes Street\",\n \"addressLine2\": \"\",\n \"city\": \"Los Angeles\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": 1453242,\n \"poNumbers\": [\n \"04112024\",\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"abc@fourkites.com\",\n \"phone\": \"1234456734\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"earliestWantTime\": \"2024-04-22T16:31:29\",\n \"latestWantTime\": \"2024-04-22T16:31:29\",\n \"name\": \"Hammond, LA DC\",\n \"pallets\": [\n {\n \"billOfLading\": 43489495,\n \"number\": \"00001\",\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"postalCode\": \"70401\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 2,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D41\",\n \"stopType\": \"delivery\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": true,\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125,\n \"freightCost\": 10,\n \"additionalCharges\": 5,\n \"tariffCost\": 2.5,\n \"fourKitesCalculatedTariffCost\": 2.5,\n \"totalLandedCost\": 132.5,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D41\",\n \"handlingUnitId\": \"00001\",\n \"barcode\": \"1KYGR\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678912\",\n \"customerPartNumber\": \"1KYGR\",\n \"supplierPartNumber\": \"1KYGR\",\n \"manufacturerPartNumber\": \"MFG-1KYGR\",\n \"itemNumber\": \"ITM-1KYGR\",\n \"productUpc\": \"012345678912\",\n \"deliveryReferences\": [\n \"BOL:43489495\"\n ],\n \"orderReferences\": [\n \"SO:G024307300\"\n ],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGR\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"QR_CODE\"\n }\n ]\n }\n ]\n }\n }),\n};\n\n$.ajax(settings).done(function (response) {\n console.log(response);\n});", "customLabel": "" }, { "id": "Wa5iZnk2mQYNur1oRW3cy", "language": "swift", "code": "let parameters = \"{\\n \\\"simpleUpdate\\\": \\\"True\\\",\\n \\\"trackingInfo\\\": {\\n \\\"driverPhone\\\": \\\"\\\",\\n \\\"truckNumber\\\": \\\"\\\",\\n \\\"trailerNumber\\\": \\\"\\\"\\n },\\n \\\"additionalData\\\": {\\n \\\"modeDetails\\\": {\\n \\\"shipperModes\\\": \\\"Parcel\\\"\\n }\\n },\\n \\\"load\\\": {\\n \\\"carrier\\\": \\\"cc79\\\",\\n \\\"haulType\\\": [\\n \\\"outbound_load\\\"\\n ],\\n \\\"simultaneousTrackingReferenceNumber\\\": \\\"simul123\\\",\\n \\\"masterSequenceNumber\\\": null,\\n \\\"simultaneousTrackingSequenceNumber\\\": 1,\\n \\\"trackingNumber\\\": \\\"1122334455\\\",\\n \\\"loadNumber\\\": \\\"TestParcelUpdate\\\",\\n \\\"priority\\\": \\\"normal\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"LID:3454353,43534535\\\",\\n \\\"BOL:5343,764345\\\",\\n \\\"TMSID:L23432\\\",\\n \\\"L34535\\\",\\n \\\"SCAC:SER1\\\"\\n ],\\n \\\"relayLoad\\\": false,\\n \\\"stops\\\": [\\n {\\n \\\"addressLine1\\\": \\\"500 West Madison Street\\\",\\n \\\"addressLine2\\\": \\\"Suite 3300\\\",\\n \\\"city\\\": \\\"Chicago\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"name\\\": \\\"FourKites HQ\\\",\\n \\\"postalCode\\\": \\\"60611\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"STNR:D43\\\",\\n \\\"BOL:43489495\\\",\\n \\\"43489495\\\",\\n \\\"SO:G024307300\\\"\\n ],\\n \\\"sequence\\\": 1,\\n \\\"state\\\": \\\"LA\\\",\\n \\\"stopReferenceId\\\": \\\"D43\\\",\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"unloadTimeInMinutes\\\": 120,\\n \\\"timeInUtc\\\": true,\\n \\\"customer\\\": {\\n \\\"id\\\": null,\\n \\\"poNumbers\\\": [\\n \\\"04112024\\\"\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"email\\\": \\\"xyz@fourkites.com\\\",\\n \\\"phone\\\": \\\"545454\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2024-04-21T19:16:15\\\",\\n \\\"latestAppointmentTime\\\": \\\"2024-04-21T19:16:15\\\",\\n \\\"earliestWantTime\\\": \\\"2024-04-21T16:31:29\\\",\\n \\\"latestWantTime\\\": \\\"2024-04-21T16:31:29\\\",\\n \\\"pallets\\\": [\\n {\\n \\\"parts\\\": [\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"weight\\\": \\\"7.998\\\"\\n },\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGR\\\",\\n \\\"weight\\\": \\\"36.800\\\"\\n }\\n ]\\n }\\n ],\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"0123456\\\",\\n \\\"productName\\\": \\\"Parcel Item\\\",\\n \\\"productDescription\\\": \\\"Parcel shipment item\\\",\\n \\\"productCategory\\\": \\\"General Merchandise\\\",\\n \\\"quantity\\\": 5,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 44.8,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 25.0,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 125.00,\\n \\\"freightCost\\\": 10.00,\\n \\\"bestBeforeDate\\\": \\\"2024-04-25T00:00:00Z\\\",\\n \\\"additionalCharges\\\": 5.00,\\n \\\"tariffCost\\\": 2.50,\\n \\\"fourKitesCalculatedTariffCost\\\": 2.50,\\n \\\"totalLandedCost\\\": 132.50,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"4819500000\\\",\\n \\\"commodityTypeCode\\\": \\\"GENERAL_MERCHANDISE\\\",\\n \\\"htsusCode\\\": \\\"4819500000\\\",\\n \\\"orderNumber\\\": \\\"04112024\\\",\\n \\\"deliveryNumber\\\": \\\"DN-D43\\\",\\n \\\"handlingUnitId\\\": \\\"1KYGQ\\\",\\n \\\"barcode\\\": \\\"1KYGQ\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"00012345678905\\\",\\n \\\"customerPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"supplierPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-1KYGQ\\\",\\n \\\"itemNumber\\\": \\\"ITM-1KYGQ\\\",\\n \\\"productUpc\\\": \\\"012345678905\\\",\\n \\\"deliveryReferences\\\": [\\\"BOL:43489495\\\"],\\n \\\"orderReferences\\\": [\\\"SO:G024307300\\\"],\\n \\\"brandName\\\": \\\"Generic Merchandise Co\\\",\\n \\\"minimumTemperature\\\": 0,\\n \\\"maximumTemperature\\\": 0,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-1KYGQ\\\",\\n \\\"productTrackingNumber\\\": \\\"1122334455\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n }\\n ]\\n },\\n {\\n \\\"addressLine1\\\": \\\"425 South Palos Verdes Street\\\",\\n \\\"addressLine2\\\": \\\"\\\",\\n \\\"city\\\": \\\"Los Angeles\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": 1453242,\\n \\\"poNumbers\\\": [\\n \\\"04112024\\\",\\n \\\"04112024\\\"\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"email\\\": \\\"abc@fourkites.com\\\",\\n \\\"phone\\\": \\\"1234456734\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2024-04-22T19:16:15\\\",\\n \\\"latestAppointmentTime\\\": \\\"2024-04-22T19:16:15\\\",\\n \\\"earliestWantTime\\\": \\\"2024-04-22T16:31:29\\\",\\n \\\"latestWantTime\\\": \\\"2024-04-22T16:31:29\\\",\\n \\\"name\\\": \\\"Hammond, LA DC\\\",\\n \\\"pallets\\\": [\\n {\\n \\\"billOfLading\\\": 43489495,\\n \\\"number\\\": \\\"00001\\\",\\n \\\"parts\\\": [\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"weight\\\": \\\"7.998\\\"\\n },\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGR\\\",\\n \\\"weight\\\": \\\"36.800\\\"\\n }\\n ]\\n }\\n ],\\n \\\"postalCode\\\": \\\"70401\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"STNR:D43\\\",\\n \\\"BOL:43489495\\\",\\n \\\"43489495\\\",\\n \\\"SO:G024307300\\\"\\n ],\\n \\\"sequence\\\": 2,\\n \\\"state\\\": \\\"LA\\\",\\n \\\"stopReferenceId\\\": \\\"D41\\\",\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"unloadTimeInMinutes\\\": 120,\\n \\\"timeInUtc\\\": true,\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"0123456\\\",\\n \\\"productName\\\": \\\"Parcel Item\\\",\\n \\\"productDescription\\\": \\\"Parcel shipment item\\\",\\n \\\"productCategory\\\": \\\"General Merchandise\\\",\\n \\\"quantity\\\": 5,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 44.8,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 25.0,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 125.00,\\n \\\"freightCost\\\": 10.00,\\n \\\"additionalCharges\\\": 5.00,\\n \\\"tariffCost\\\": 2.50,\\n \\\"fourKitesCalculatedTariffCost\\\": 2.50,\\n \\\"totalLandedCost\\\": 132.50,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"4819500000\\\",\\n \\\"commodityTypeCode\\\": \\\"GENERAL_MERCHANDISE\\\",\\n \\\"htsusCode\\\": \\\"4819500000\\\",\\n \\\"orderNumber\\\": \\\"04112024\\\",\\n \\\"deliveryNumber\\\": \\\"DN-D41\\\",\\n \\\"handlingUnitId\\\": \\\"00001\\\",\\n \\\"barcode\\\": \\\"1KYGR\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"00012345678912\\\",\\n \\\"customerPartNumber\\\": \\\"1KYGR\\\",\\n \\\"supplierPartNumber\\\": \\\"1KYGR\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-1KYGR\\\",\\n \\\"itemNumber\\\": \\\"ITM-1KYGR\\\",\\n \\\"productUpc\\\": \\\"012345678912\\\",\\n \\\"deliveryReferences\\\": [\\\"BOL:43489495\\\"],\\n \\\"orderReferences\\\": [\\\"SO:G024307300\\\"],\\n \\\"brandName\\\": \\\"Generic Merchandise Co\\\",\\n \\\"minimumTemperature\\\": 0,\\n \\\"maximumTemperature\\\": 0,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-1KYGR\\\",\\n \\\"productTrackingNumber\\\": \\\"1122334455\\\",\\n \\\"deviceType\\\": \\\"QR_CODE\\\"\\n }\\n ]\\n }\\n ]\\n }\\n}\"\nlet postData = parameters.data(using: .utf8)\n\nvar request = URLRequest(url: URL(string: \"https://api-staging.fourkites.com/api/v1/tracking/417537760\")!,timeoutInterval: Double.infinity)\nrequest.addValue(\"application/json\", forHTTPHeaderField: \"Content-Type\")\nrequest.addValue(\"REPLACE_KEY_VALUE\", forHTTPHeaderField: \"apikey\")\n\nrequest.httpMethod = \"PATCH\"\nrequest.httpBody = postData\n\nlet task = URLSession.shared.dataTask(with: request) { data, response, error in \n guard let data = data else {\n print(String(describing: error))\n return\n }\n print(String(data: data, encoding: .utf8)!)\n}\n\ntask.resume()\n", "customLabel": "" }, { "id": "HniLgknzNj5Bx76jN_m0T", "language": "csharp", "code": "var client = new HttpClient();\nvar request = new HttpRequestMessage(HttpMethod.Patch, \"https://api-staging.fourkites.com/api/v1/tracking/417537760\");\nrequest.Headers.Add(\"apikey\", \"REPLACE_KEY_VALUE\");\nvar content = new StringContent(\"{\\n \\\"simpleUpdate\\\": \\\"True\\\",\\n \\\"trackingInfo\\\": {\\n \\\"driverPhone\\\": \\\"\\\",\\n \\\"truckNumber\\\": \\\"\\\",\\n \\\"trailerNumber\\\": \\\"\\\"\\n },\\n \\\"additionalData\\\": {\\n \\\"modeDetails\\\": {\\n \\\"shipperModes\\\": \\\"Parcel\\\"\\n }\\n },\\n \\\"load\\\": {\\n \\\"carrier\\\": \\\"cc79\\\",\\n \\\"haulType\\\": [\\n \\\"outbound_load\\\"\\n ],\\n \\\"simultaneousTrackingReferenceNumber\\\": \\\"simul123\\\",\\n \\\"masterSequenceNumber\\\": null,\\n \\\"simultaneousTrackingSequenceNumber\\\": 1,\\n \\\"trackingNumber\\\": \\\"1122334455\\\",\\n \\\"loadNumber\\\": \\\"TestParcelUpdate\\\",\\n \\\"priority\\\": \\\"normal\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"LID:3454353,43534535\\\",\\n \\\"BOL:5343,764345\\\",\\n \\\"TMSID:L23432\\\",\\n \\\"L34535\\\",\\n \\\"SCAC:SER1\\\"\\n ],\\n \\\"relayLoad\\\": false,\\n \\\"stops\\\": [\\n {\\n \\\"addressLine1\\\": \\\"500 West Madison Street\\\",\\n \\\"addressLine2\\\": \\\"Suite 3300\\\",\\n \\\"city\\\": \\\"Chicago\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"name\\\": \\\"FourKites HQ\\\",\\n \\\"postalCode\\\": \\\"60611\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"STNR:D43\\\",\\n \\\"BOL:43489495\\\",\\n \\\"43489495\\\",\\n \\\"SO:G024307300\\\"\\n ],\\n \\\"sequence\\\": 1,\\n \\\"state\\\": \\\"LA\\\",\\n \\\"stopReferenceId\\\": \\\"D43\\\",\\n \\\"stopType\\\": \\\"pickup\\\",\\n \\\"unloadTimeInMinutes\\\": 120,\\n \\\"timeInUtc\\\": true,\\n \\\"customer\\\": {\\n \\\"id\\\": null,\\n \\\"poNumbers\\\": [\\n \\\"04112024\\\"\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"email\\\": \\\"xyz@fourkites.com\\\",\\n \\\"phone\\\": \\\"545454\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2024-04-21T19:16:15\\\",\\n \\\"latestAppointmentTime\\\": \\\"2024-04-21T19:16:15\\\",\\n \\\"earliestWantTime\\\": \\\"2024-04-21T16:31:29\\\",\\n \\\"latestWantTime\\\": \\\"2024-04-21T16:31:29\\\",\\n \\\"pallets\\\": [\\n {\\n \\\"parts\\\": [\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"weight\\\": \\\"7.998\\\"\\n },\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGR\\\",\\n \\\"weight\\\": \\\"36.800\\\"\\n }\\n ]\\n }\\n ],\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"0123456\\\",\\n \\\"productName\\\": \\\"Parcel Item\\\",\\n \\\"productDescription\\\": \\\"Parcel shipment item\\\",\\n \\\"productCategory\\\": \\\"General Merchandise\\\",\\n \\\"quantity\\\": 5,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 44.8,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 25.0,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 125.00,\\n \\\"freightCost\\\": 10.00,\\n \\\"bestBeforeDate\\\": \\\"2024-04-25T00:00:00Z\\\",\\n \\\"additionalCharges\\\": 5.00,\\n \\\"tariffCost\\\": 2.50,\\n \\\"fourKitesCalculatedTariffCost\\\": 2.50,\\n \\\"totalLandedCost\\\": 132.50,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"4819500000\\\",\\n \\\"commodityTypeCode\\\": \\\"GENERAL_MERCHANDISE\\\",\\n \\\"htsusCode\\\": \\\"4819500000\\\",\\n \\\"orderNumber\\\": \\\"04112024\\\",\\n \\\"deliveryNumber\\\": \\\"DN-D43\\\",\\n \\\"handlingUnitId\\\": \\\"1KYGQ\\\",\\n \\\"barcode\\\": \\\"1KYGQ\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"00012345678905\\\",\\n \\\"customerPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"supplierPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-1KYGQ\\\",\\n \\\"itemNumber\\\": \\\"ITM-1KYGQ\\\",\\n \\\"productUpc\\\": \\\"012345678905\\\",\\n \\\"deliveryReferences\\\": [\\\"BOL:43489495\\\"],\\n \\\"orderReferences\\\": [\\\"SO:G024307300\\\"],\\n \\\"brandName\\\": \\\"Generic Merchandise Co\\\",\\n \\\"minimumTemperature\\\": 0,\\n \\\"maximumTemperature\\\": 0,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-1KYGQ\\\",\\n \\\"productTrackingNumber\\\": \\\"1122334455\\\",\\n \\\"deviceType\\\": \\\"RFID_TAG\\\"\\n }\\n ]\\n },\\n {\\n \\\"addressLine1\\\": \\\"425 South Palos Verdes Street\\\",\\n \\\"addressLine2\\\": \\\"\\\",\\n \\\"city\\\": \\\"Los Angeles\\\",\\n \\\"country\\\": \\\"US\\\",\\n \\\"customer\\\": {\\n \\\"id\\\": 1453242,\\n \\\"poNumbers\\\": [\\n \\\"04112024\\\",\\n \\\"04112024\\\"\\n ],\\n \\\"pointOfContact\\\": {\\n \\\"email\\\": \\\"abc@fourkites.com\\\",\\n \\\"phone\\\": \\\"1234456734\\\"\\n }\\n },\\n \\\"earliestAppointmentTime\\\": \\\"2024-04-22T19:16:15\\\",\\n \\\"latestAppointmentTime\\\": \\\"2024-04-22T19:16:15\\\",\\n \\\"earliestWantTime\\\": \\\"2024-04-22T16:31:29\\\",\\n \\\"latestWantTime\\\": \\\"2024-04-22T16:31:29\\\",\\n \\\"name\\\": \\\"Hammond, LA DC\\\",\\n \\\"pallets\\\": [\\n {\\n \\\"billOfLading\\\": 43489495,\\n \\\"number\\\": \\\"00001\\\",\\n \\\"parts\\\": [\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGQ\\\",\\n \\\"weight\\\": \\\"7.998\\\"\\n },\\n {\\n \\\"quantity\\\": \\\"CARTON-WMS\\\",\\n \\\"shipperPartNumber\\\": \\\"1KYGR\\\",\\n \\\"weight\\\": \\\"36.800\\\"\\n }\\n ]\\n }\\n ],\\n \\\"postalCode\\\": \\\"70401\\\",\\n \\\"referenceNumbers\\\": [\\n \\\"STNR:D43\\\",\\n \\\"BOL:43489495\\\",\\n \\\"43489495\\\",\\n \\\"SO:G024307300\\\"\\n ],\\n \\\"sequence\\\": 2,\\n \\\"state\\\": \\\"LA\\\",\\n \\\"stopReferenceId\\\": \\\"D41\\\",\\n \\\"stopType\\\": \\\"delivery\\\",\\n \\\"unloadTimeInMinutes\\\": 120,\\n \\\"timeInUtc\\\": true,\\n \\\"productLineItems\\\": [\\n {\\n \\\"productId\\\": \\\"0123456\\\",\\n \\\"productName\\\": \\\"Parcel Item\\\",\\n \\\"productDescription\\\": \\\"Parcel shipment item\\\",\\n \\\"productCategory\\\": \\\"General Merchandise\\\",\\n \\\"quantity\\\": 5,\\n \\\"measurementUnitCode\\\": \\\"PCE\\\",\\n \\\"netWeight\\\": 44.8,\\n \\\"weightUnit\\\": \\\"KGM\\\",\\n \\\"unitCost\\\": 25.0,\\n \\\"currencyCode\\\": \\\"USD\\\",\\n \\\"extendedCost\\\": 125.00,\\n \\\"freightCost\\\": 10.00,\\n \\\"additionalCharges\\\": 5.00,\\n \\\"tariffCost\\\": 2.50,\\n \\\"fourKitesCalculatedTariffCost\\\": 2.50,\\n \\\"totalLandedCost\\\": 132.50,\\n \\\"countryOfOrigin\\\": \\\"US\\\",\\n \\\"harmonizedSystemCode\\\": \\\"4819500000\\\",\\n \\\"commodityTypeCode\\\": \\\"GENERAL_MERCHANDISE\\\",\\n \\\"htsusCode\\\": \\\"4819500000\\\",\\n \\\"orderNumber\\\": \\\"04112024\\\",\\n \\\"deliveryNumber\\\": \\\"DN-D41\\\",\\n \\\"handlingUnitId\\\": \\\"00001\\\",\\n \\\"barcode\\\": \\\"1KYGR\\\",\\n \\\"containerType\\\": \\\"box\\\",\\n \\\"gtin\\\": \\\"00012345678912\\\",\\n \\\"customerPartNumber\\\": \\\"1KYGR\\\",\\n \\\"supplierPartNumber\\\": \\\"1KYGR\\\",\\n \\\"manufacturerPartNumber\\\": \\\"MFG-1KYGR\\\",\\n \\\"itemNumber\\\": \\\"ITM-1KYGR\\\",\\n \\\"productUpc\\\": \\\"012345678912\\\",\\n \\\"deliveryReferences\\\": [\\\"BOL:43489495\\\"],\\n \\\"orderReferences\\\": [\\\"SO:G024307300\\\"],\\n \\\"brandName\\\": \\\"Generic Merchandise Co\\\",\\n \\\"minimumTemperature\\\": 0,\\n \\\"maximumTemperature\\\": 0,\\n \\\"temperatureUnitCode\\\": \\\"cel\\\",\\n \\\"labelIdentifier\\\": \\\"LBL-1KYGR\\\",\\n \\\"productTrackingNumber\\\": \\\"1122334455\\\",\\n \\\"deviceType\\\": \\\"QR_CODE\\\"\\n }\\n ]\\n }\\n ]\\n }\\n}\", null, \"application/json\");\nrequest.Content = content;\nvar response = await client.SendAsync(request);\nresponse.EnsureSuccessStatusCode();\nConsole.WriteLine(await response.Content.ReadAsStringAsync());\n", "customLabel": "" }, { "id": "9zcwM7HetabBQtdATlUj9", "language": "go", "code": "package main\n\nimport (\n \"fmt\"\n \"strings\"\n \"net/http\"\n \"io/ioutil\"\n)\n\nfunc main() {\n\n url := \"https://api-staging.fourkites.com/api/v1/tracking/417537760\"\n method := \"PATCH\"\n\n payload := strings.NewReader(`{\n \"simpleUpdate\": \"True\",\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"truckNumber\": \"\",\n \"trailerNumber\": \"\"\n },\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"Parcel\"\n }\n },\n \"load\": {\n \"carrier\": \"cc79\",\n \"haulType\": [\n \"outbound_load\"\n ],\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"masterSequenceNumber\": null,\n \"simultaneousTrackingSequenceNumber\": 1,\n \"trackingNumber\": \"1122334455\",\n \"loadNumber\": \"TestParcelUpdate\",\n \"priority\": \"normal\",\n \"referenceNumbers\": [\n \"LID:3454353,43534535\",\n \"BOL:5343,764345\",\n \"TMSID:L23432\",\n \"L34535\",\n \"SCAC:SER1\"\n ],\n \"relayLoad\": false,\n \"stops\": [\n {\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Suite 3300\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"name\": \"FourKites HQ\",\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 1,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D43\",\n \"stopType\": \"pickup\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": true,\n \"customer\": {\n \"id\": null,\n \"poNumbers\": [\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"xyz@fourkites.com\",\n \"phone\": \"545454\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"earliestWantTime\": \"2024-04-21T16:31:29\",\n \"latestWantTime\": \"2024-04-21T16:31:29\",\n \"pallets\": [\n {\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25.0,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125.00,\n \"freightCost\": 10.00,\n \"bestBeforeDate\": \"2024-04-25T00:00:00Z\",\n \"additionalCharges\": 5.00,\n \"tariffCost\": 2.50,\n \"fourKitesCalculatedTariffCost\": 2.50,\n \"totalLandedCost\": 132.50,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D43\",\n \"handlingUnitId\": \"1KYGQ\",\n \"barcode\": \"1KYGQ\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678905\",\n \"customerPartNumber\": \"1KYGQ\",\n \"supplierPartNumber\": \"1KYGQ\",\n \"manufacturerPartNumber\": \"MFG-1KYGQ\",\n \"itemNumber\": \"ITM-1KYGQ\",\n \"productUpc\": \"012345678905\",\n \"deliveryReferences\": [\"BOL:43489495\"],\n \"orderReferences\": [\"SO:G024307300\"],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGQ\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"RFID_TAG\"\n }\n ]\n },\n {\n \"addressLine1\": \"425 South Palos Verdes Street\",\n \"addressLine2\": \"\",\n \"city\": \"Los Angeles\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": 1453242,\n \"poNumbers\": [\n \"04112024\",\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"abc@fourkites.com\",\n \"phone\": \"1234456734\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"earliestWantTime\": \"2024-04-22T16:31:29\",\n \"latestWantTime\": \"2024-04-22T16:31:29\",\n \"name\": \"Hammond, LA DC\",\n \"pallets\": [\n {\n \"billOfLading\": 43489495,\n \"number\": \"00001\",\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"postalCode\": \"70401\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 2,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D41\",\n \"stopType\": \"delivery\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": true,\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25.0,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125.00,\n \"freightCost\": 10.00,\n \"additionalCharges\": 5.00,\n \"tariffCost\": 2.50,\n \"fourKitesCalculatedTariffCost\": 2.50,\n \"totalLandedCost\": 132.50,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D41\",\n \"handlingUnitId\": \"00001\",\n \"barcode\": \"1KYGR\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678912\",\n \"customerPartNumber\": \"1KYGR\",\n \"supplierPartNumber\": \"1KYGR\",\n \"manufacturerPartNumber\": \"MFG-1KYGR\",\n \"itemNumber\": \"ITM-1KYGR\",\n \"productUpc\": \"012345678912\",\n \"deliveryReferences\": [\"BOL:43489495\"],\n \"orderReferences\": [\"SO:G024307300\"],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGR\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"QR_CODE\"\n }\n ]\n }\n ]\n }\n}`)\n\n client := &http.Client {\n }\n req, err := http.NewRequest(method, url, payload)\n\n if err != nil {\n fmt.Println(err)\n return\n }\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"apikey\", \"REPLACE_KEY_VALUE\")\n\n res, err := client.Do(req)\n if err != nil {\n fmt.Println(err)\n return\n }\n defer res.Body.Close()\n\n body, err := ioutil.ReadAll(res.Body)\n if err != nil {\n fmt.Println(err)\n return\n }\n fmt.Println(string(body))\n}", "customLabel": "" }, { "id": "O9by-LSR9sP8Q9TVUT5I8", "language": "ruby", "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api-staging.fourkites.com/api/v1/tracking/417537760\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Patch.new(url)\nrequest[\"Content-Type\"] = \"application/json\"\nrequest[\"apikey\"] = \"REPLACE_KEY_VALUE\"\nrequest.body = JSON.dump({\n \"simpleUpdate\": \"True\",\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"truckNumber\": \"\",\n \"trailerNumber\": \"\"\n },\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"Parcel\"\n }\n },\n \"load\": {\n \"carrier\": \"cc79\",\n \"haulType\": [\n \"outbound_load\"\n ],\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"masterSequenceNumber\": nil,\n \"simultaneousTrackingSequenceNumber\": 1,\n \"trackingNumber\": \"1122334455\",\n \"loadNumber\": \"TestParcelUpdate\",\n \"priority\": \"normal\",\n \"referenceNumbers\": [\n \"LID:3454353,43534535\",\n \"BOL:5343,764345\",\n \"TMSID:L23432\",\n \"L34535\",\n \"SCAC:SER1\"\n ],\n \"relayLoad\": false,\n \"stops\": [\n {\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Suite 3300\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"name\": \"FourKites HQ\",\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 1,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D43\",\n \"stopType\": \"pickup\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": true,\n \"customer\": {\n \"id\": nil,\n \"poNumbers\": [\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"xyz@fourkites.com\",\n \"phone\": \"545454\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"earliestWantTime\": \"2024-04-21T16:31:29\",\n \"latestWantTime\": \"2024-04-21T16:31:29\",\n \"pallets\": [\n {\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125,\n \"freightCost\": 10,\n \"bestBeforeDate\": \"2024-04-25T00:00:00Z\",\n \"additionalCharges\": 5,\n \"tariffCost\": 2.5,\n \"fourKitesCalculatedTariffCost\": 2.5,\n \"totalLandedCost\": 132.5,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D43\",\n \"handlingUnitId\": \"1KYGQ\",\n \"barcode\": \"1KYGQ\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678905\",\n \"customerPartNumber\": \"1KYGQ\",\n \"supplierPartNumber\": \"1KYGQ\",\n \"manufacturerPartNumber\": \"MFG-1KYGQ\",\n \"itemNumber\": \"ITM-1KYGQ\",\n \"productUpc\": \"012345678905\",\n \"deliveryReferences\": [\n \"BOL:43489495\"\n ],\n \"orderReferences\": [\n \"SO:G024307300\"\n ],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGQ\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"RFID_TAG\"\n }\n ]\n },\n {\n \"addressLine1\": \"425 South Palos Verdes Street\",\n \"addressLine2\": \"\",\n \"city\": \"Los Angeles\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": 1453242,\n \"poNumbers\": [\n \"04112024\",\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"abc@fourkites.com\",\n \"phone\": \"1234456734\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"earliestWantTime\": \"2024-04-22T16:31:29\",\n \"latestWantTime\": \"2024-04-22T16:31:29\",\n \"name\": \"Hammond, LA DC\",\n \"pallets\": [\n {\n \"billOfLading\": 43489495,\n \"number\": \"00001\",\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"postalCode\": \"70401\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 2,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D41\",\n \"stopType\": \"delivery\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": true,\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125,\n \"freightCost\": 10,\n \"additionalCharges\": 5,\n \"tariffCost\": 2.5,\n \"fourKitesCalculatedTariffCost\": 2.5,\n \"totalLandedCost\": 132.5,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D41\",\n \"handlingUnitId\": \"00001\",\n \"barcode\": \"1KYGR\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678912\",\n \"customerPartNumber\": \"1KYGR\",\n \"supplierPartNumber\": \"1KYGR\",\n \"manufacturerPartNumber\": \"MFG-1KYGR\",\n \"itemNumber\": \"ITM-1KYGR\",\n \"productUpc\": \"012345678912\",\n \"deliveryReferences\": [\n \"BOL:43489495\"\n ],\n \"orderReferences\": [\n \"SO:G024307300\"\n ],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGR\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"QR_CODE\"\n }\n ]\n }\n ]\n }\n})\n\nresponse = https.request(request)\nputs response.read_body\n", "customLabel": "" }, { "id": "rUTBIPR4eat_H8Raawgsv", "language": "python", "code": "import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api-staging.fourkites.com\")\npayload = json.dumps({\n \"simpleUpdate\": \"True\",\n \"trackingInfo\": {\n \"driverPhone\": \"\",\n \"truckNumber\": \"\",\n \"trailerNumber\": \"\"\n },\n \"additionalData\": {\n \"modeDetails\": {\n \"shipperModes\": \"Parcel\"\n }\n },\n \"load\": {\n \"carrier\": \"cc79\",\n \"haulType\": [\n \"outbound_load\"\n ],\n \"simultaneousTrackingReferenceNumber\": \"simul123\",\n \"masterSequenceNumber\": None,\n \"simultaneousTrackingSequenceNumber\": 1,\n \"trackingNumber\": \"1122334455\",\n \"loadNumber\": \"TestParcelUpdate\",\n \"priority\": \"normal\",\n \"referenceNumbers\": [\n \"LID:3454353,43534535\",\n \"BOL:5343,764345\",\n \"TMSID:L23432\",\n \"L34535\",\n \"SCAC:SER1\"\n ],\n \"relayLoad\": False,\n \"stops\": [\n {\n \"addressLine1\": \"500 West Madison Street\",\n \"addressLine2\": \"Suite 3300\",\n \"city\": \"Chicago\",\n \"country\": \"US\",\n \"name\": \"FourKites HQ\",\n \"postalCode\": \"60611\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 1,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D43\",\n \"stopType\": \"pickup\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": True,\n \"customer\": {\n \"id\": None,\n \"poNumbers\": [\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"xyz@fourkites.com\",\n \"phone\": \"545454\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-21T19:16:15\",\n \"earliestWantTime\": \"2024-04-21T16:31:29\",\n \"latestWantTime\": \"2024-04-21T16:31:29\",\n \"pallets\": [\n {\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125,\n \"freightCost\": 10,\n \"bestBeforeDate\": \"2024-04-25T00:00:00Z\",\n \"additionalCharges\": 5,\n \"tariffCost\": 2.5,\n \"fourKitesCalculatedTariffCost\": 2.5,\n \"totalLandedCost\": 132.5,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D43\",\n \"handlingUnitId\": \"1KYGQ\",\n \"barcode\": \"1KYGQ\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678905\",\n \"customerPartNumber\": \"1KYGQ\",\n \"supplierPartNumber\": \"1KYGQ\",\n \"manufacturerPartNumber\": \"MFG-1KYGQ\",\n \"itemNumber\": \"ITM-1KYGQ\",\n \"productUpc\": \"012345678905\",\n \"deliveryReferences\": [\n \"BOL:43489495\"\n ],\n \"orderReferences\": [\n \"SO:G024307300\"\n ],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGQ\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"RFID_TAG\"\n }\n ]\n },\n {\n \"addressLine1\": \"425 South Palos Verdes Street\",\n \"addressLine2\": \"\",\n \"city\": \"Los Angeles\",\n \"country\": \"US\",\n \"customer\": {\n \"id\": 1453242,\n \"poNumbers\": [\n \"04112024\",\n \"04112024\"\n ],\n \"pointOfContact\": {\n \"email\": \"abc@fourkites.com\",\n \"phone\": \"1234456734\"\n }\n },\n \"earliestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"latestAppointmentTime\": \"2024-04-22T19:16:15\",\n \"earliestWantTime\": \"2024-04-22T16:31:29\",\n \"latestWantTime\": \"2024-04-22T16:31:29\",\n \"name\": \"Hammond, LA DC\",\n \"pallets\": [\n {\n \"billOfLading\": 43489495,\n \"number\": \"00001\",\n \"parts\": [\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGQ\",\n \"weight\": \"7.998\"\n },\n {\n \"quantity\": \"CARTON-WMS\",\n \"shipperPartNumber\": \"1KYGR\",\n \"weight\": \"36.800\"\n }\n ]\n }\n ],\n \"postalCode\": \"70401\",\n \"referenceNumbers\": [\n \"STNR:D43\",\n \"BOL:43489495\",\n \"43489495\",\n \"SO:G024307300\"\n ],\n \"sequence\": 2,\n \"state\": \"LA\",\n \"stopReferenceId\": \"D41\",\n \"stopType\": \"delivery\",\n \"unloadTimeInMinutes\": 120,\n \"timeInUtc\": True,\n \"productLineItems\": [\n {\n \"productId\": \"0123456\",\n \"productName\": \"Parcel Item\",\n \"productDescription\": \"Parcel shipment item\",\n \"productCategory\": \"General Merchandise\",\n \"quantity\": 5,\n \"measurementUnitCode\": \"PCE\",\n \"netWeight\": 44.8,\n \"weightUnit\": \"KGM\",\n \"unitCost\": 25,\n \"currencyCode\": \"USD\",\n \"extendedCost\": 125,\n \"freightCost\": 10,\n \"additionalCharges\": 5,\n \"tariffCost\": 2.5,\n \"fourKitesCalculatedTariffCost\": 2.5,\n \"totalLandedCost\": 132.5,\n \"countryOfOrigin\": \"US\",\n \"harmonizedSystemCode\": \"4819500000\",\n \"commodityTypeCode\": \"GENERAL_MERCHANDISE\",\n \"htsusCode\": \"4819500000\",\n \"orderNumber\": \"04112024\",\n \"deliveryNumber\": \"DN-D41\",\n \"handlingUnitId\": \"00001\",\n \"barcode\": \"1KYGR\",\n \"containerType\": \"box\",\n \"gtin\": \"00012345678912\",\n \"customerPartNumber\": \"1KYGR\",\n \"supplierPartNumber\": \"1KYGR\",\n \"manufacturerPartNumber\": \"MFG-1KYGR\",\n \"itemNumber\": \"ITM-1KYGR\",\n \"productUpc\": \"012345678912\",\n \"deliveryReferences\": [\n \"BOL:43489495\"\n ],\n \"orderReferences\": [\n \"SO:G024307300\"\n ],\n \"brandName\": \"Generic Merchandise Co\",\n \"minimumTemperature\": 0,\n \"maximumTemperature\": 0,\n \"temperatureUnitCode\": \"cel\",\n \"labelIdentifier\": \"LBL-1KYGR\",\n \"productTrackingNumber\": \"1122334455\",\n \"deviceType\": \"QR_CODE\"\n }\n ]\n }\n ]\n }\n})\nheaders = {\n 'Content-Type': 'application/json',\n 'apikey': 'REPLACE_KEY_VALUE'\n}\nconn.request(\"PATCH\", \"/api/v1/tracking/417537760\", payload, headers)\nres = conn.getresponse()\ndata = res.read()\nprint(data.decode(\"utf-8\"))", "customLabel": "" } ], "selectedLanguageId": "rUTBIPR4eat_H8Raawgsv" }, "results": { "languages": [ { "id": "gmDgZ35TuXHqAL2aXteyy", "language": "200", "customLabel": "", "code": "{\n \"message\": \"Load updated successfully\",\n \"requestId\": \"cojn90c6o9momjnsuam0\",\n \"statusCode\": 200\n}" } ], "selectedLanguageId": "gmDgZ35TuXHqAL2aXteyy" }, "request": { "pathParameters": [], "queryParameters": [], "headerParameters": [], "bodyDataParameters": [ { "name": "simpleUpdate", "kind": "optional", "type": "string", "description": "Indicates whether the load object in the request payload is the complete snapshot of the load to be updated. Default to false. Valid values: true or false.", "": "simpleUpdate" }, { "name": "trackingInfo", "kind": "optional", "type": "object", "description": "It indicates the information required for tracking the load.", "children": [ { "name": "driverPhone", "kind": "optional", "type": "string", "description": "It indicates a valid mobile number. Example: +13125555555" }, { "name": "truckNumber", "kind": "optional", "type": "string", "description": "It indicates the tractor or asset number dispatched by the carrier for the load." }, { "name": "trailerNumber", "kind": "optional", "type": "string", "description": "It indicates the trailer number assigned to the load." } ] }, { "name": "modeDetails", "kind": "optional", "type": "string", "description": "It defines the mode of the load. Valid values: \"Parcel\"" }, { "name": "load", "kind": "required", "type": "object", "description": "It is the parent object for the load. Place the load attributes inside this object.", "children": [ { "name": "carrier", "kind": "required", "type": "string", "description": "It is the SCAC or Service Provider ID of the carrier assigned to the load. The carrier should have approved sharing of their telematics data on FourKites® for the customer." }, { "name": "haulType", "kind": "optional", "type": "array", "description": "It indicates whether the load is an inbound or an outbound load. Valid values: \"inbound_load\", \"outbound_load\", \"short_haul\", \"round_trip\", \"brokered_load\", \"non-brokered_load\", \"inbound_load\", \"outbound_load\", travel_ban_warnings\"" }, { "name": "simultaneousTrackingReferenceNumber", "kind": "optional", "type": "string", "description": "It indicates a common reference number across a group of simultaneous loads in order to group them. For example, simultaneousTrackingReferenceNumber: “E900018290”" }, { "name": "masterSequenceNumber", "kind": "optional", "type": "string", "description": "It is the unique sequence number that represents the leg of the trip used for Consignment Pooling." }, { "name": "trackingNumber", "kind": "optional", "type": "string", "description": "It indicates the small parcel tracking number used for the load." }, { "name": "loadNumber", "kind": "required", "type": "string", "description": "It is the unique load identifier from shipper's system. The load Number or BOL is an important piece of information used to link the load with truck information received from the Carrier's TMS." }, { "name": "priority", "kind": "optional", "type": "string", "description": "It indicates whether a load is of normal or high priority. If priority is set as ‘hot’, the load will be marked as ‘Hot’. Valid values: ‘normal’, ‘high’ and ‘hot’. Defaults to normal. Setting the 'Priority' as 'hot' will mark the load as 'Hot' load." }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It is the list of load-level reference numbers associated with a load. (CM)" }, { "name": "relayLoad", "kind": "optional", "type": "boolean", "description": "It indicates whether the load is relay or team load. \tValid values: true or false. Defaults to false. (CM)" }, { "name": "stops", "kind": "required", "type": "object", "description": "It is the list of stops for the load.", "children": [ { "name": "addressLine1", "kind": "required", "type": "string", "description": "It indicates the first line of the stop's address." }, { "name": "addressLine2", "kind": "optional", "type": "string", "description": "It indicates the second line of the stop's address." }, { "name": "city", "kind": "required", "type": "string", "description": "It indicates the name of the city. \tWhen we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now we have a restriction to pass state name when the stop doesn't have external AddressId and we match the port with only city & country." }, { "name": "country", "kind": "optional", "type": "string", "description": "It indicates the valid country code. It is the 2 digit country code. When we are not able to match a port with UNLOCODE, we will use city and country to find the port in the platform for port stop creation. Right now, we have a restriction to pass the state name when the stop doesn't have external AddressId and we want to match the port with only city & country." }, { "name": "name", "kind": "required", "type": "string", "description": "It is the name of the stop." }, { "name": "postalCode", "kind": "optional", "type": "string", "description": "It indicates the valid postal code for the stop." }, { "name": "referenceNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of stop level reference numbers associated with the stop. These are searchable within the FourKites platform. (CM)" }, { "name": "sequence", "kind": "optional", "type": "string", "description": "It indicates the stop's sequence on a load. The lower value indicates earliest scheduled stop completion. If the stop sequence is present for one stop on a load, it must be present on all stops. It is recommended to start at 1 and increment by 1 for each additional stop. (CM)" }, { "name": "state", "kind": "required", "type": "string", "description": "It indicates the 2 character state code for US & Canada and 3 Character state code for Mexico. It is the 2 character State Code for US & Canada and 3 Character State Code for Mexico." }, { "name": "stopReferenceId", "kind": "optional", "type": "string", "description": "It is the unique identifier of the stop from the customer's system. This populates the \"Reference #\" field on the stop and is used to indicate which stop an update is applied to. (CM)" }, { "name": "stopType", "kind": "required", "type": "string", "description": "It defines the function of the stop. Valid values: \"pickup\", \"delivery\", \"transfer\", \"portOfLoading\", \"transshipmentPort\", \"portOfDischarge\". There should be at least one pickup and delivery stop or one transfer (terminal) and one delivery." }, { "name": "unloadTimeInMinutes", "kind": "optional", "type": "string", "description": "It indicates the dwell time to be used for the stop in ETA calculations (in minutes). When it is not provided, the company level default value will be used, if available or 90 minutes. This value must be sent in minutes." }, { "name": "productLineItems", "kind": "optional", "type": "object", "description": "It is the list of product level details associated with a stop. Replaces the legacy pallets/parts structure going forward.", "children": [ { "name": "productId", "kind": "required", "type": "string", "description": "Unique identifier for the product. Mandatory if productLineItems object is present" }, { "name": "productName", "kind": "optional", "type": "string", "description": "Name of the product" }, { "name": "productDescription", "kind": "optional", "type": "string", "description": "Detailed description of the product" }, { "name": "productCategory", "kind": "optional", "type": "string", "description": "Category classification of the product" }, { "name": "quantity", "kind": "optional", "type": "integer", "description": "Number of units in the shipment" }, { "name": "measurementUnitCode", "kind": "optional", "type": "string", "description": "Unit of measurement for quantity (e.g., PCE, KG, LB)" }, { "name": "netWeight", "kind": "optional", "type": "string", "description": "Weight of the product excluding packaging" }, { "name": "weightUnit", "kind": "optional", "type": "string", "description": "Unit of measurement for weight (e.g., KGM, LBM)" }, { "name": "unitCost", "kind": "optional", "type": "number", "description": "Cost per unit of the product" }, { "name": "currencyCode", "kind": "optional", "type": "string", "description": "Currency code for cost fields" }, { "name": "extendedCost", "kind": "optional", "type": "number", "description": "Total cost for all units (unitCost x quantity)" }, { "name": "freightCost", "kind": "optional", "type": "number", "description": "Freight cost allocated to this line item" }, { "name": "bestBeforeDate", "kind": "optional", "type": "string", "description": "Expiration or best before date for the product" }, { "name": "additionalCharges", "kind": "optional", "type": "number", "description": "Any additional charges specific to this line item" }, { "name": "tariffCost", "kind": "optional", "type": "number", "description": "Tariff cost for this specific line item" }, { "name": "fourKitesCalculatedTariffCost", "kind": "optional", "type": "number", "description": "System-calculated tariff cost" }, { "name": "totalLandedCost", "kind": "optional", "type": "number", "description": "Total landed cost for this line item" }, { "name": "countryOfOrigin", "kind": "optional", "type": "string", "description": "Country of origin for this product" }, { "name": "harmonizedSystemCode", "kind": "optional", "type": "string", "description": "International trade classification code" }, { "name": "commodityTypeCode", "kind": "optional", "type": "string", "description": "Commodity classification code" }, { "name": "htsusCode", "kind": "optional", "type": "string", "description": "Harmonized Tariff Schedule code for US imports" }, { "name": "orderNumber", "kind": "optional", "type": "string", "description": "Purchase order number" }, { "name": "deliveryNumber", "kind": "optional", "type": "string", "description": "Delivery reference number" }, { "name": "handlingUnitId", "kind": "optional", "type": "string", "description": "Identifier for the handling unit (pallet, box, etc.)" }, { "name": "barcode", "kind": "optional", "type": "string", "description": "Product barcode" }, { "name": "containerType", "kind": "optional", "type": "string", "description": "Type of container (pallet, box, carton, etc.)" }, { "name": "gtin", "kind": "optional", "type": "string", "description": "Global Trade Item Number" }, { "name": "customerPartNumber", "kind": "optional", "type": "string", "description": "Customer's part number for the product" }, { "name": "supplierPartNumber", "kind": "optional", "type": "string", "description": "Supplier's part number for the product" }, { "name": "manufacturerPartNumber", "kind": "optional", "type": "string", "description": "Manufacturer's part number" }, { "name": "itemNumber", "kind": "optional", "type": "string", "description": "Internal item number" }, { "name": "productUpc", "kind": "optional", "type": "string", "description": "Universal Product Code" }, { "name": "deliveryReferences", "kind": "optional", "type": "string", "description": "Array of delivery reference numbers" }, { "name": "orderReferences", "kind": "optional", "type": "string", "description": "Array of order reference numbers" }, { "name": "brandName", "kind": "optional", "type": "string", "description": "Brand name of the product" }, { "name": "minimumTemperature", "kind": "optional", "type": "integer", "description": "Minimum storage/transport temperature" }, { "name": "maximumTemperature", "kind": "optional", "type": "integer", "description": "Maximum storage/transport temperature" }, { "name": "temperatureUnitCode", "kind": "optional", "type": "string", "description": "Temperature unit (cel, fah)" }, { "name": "labelIdentifier", "kind": "optional", "type": "string", "description": "Label identifier for tracking" }, { "name": "productTrackingNumber", "kind": "optional", "type": "string", "description": "Unique tracking number for the product" }, { "name": "deviceType", "kind": "optional", "type": "string", "description": "Type of tracking device (RFID_TAG, QR_CODE, etc.)" } ] }, { "name": "timeInUtc", "kind": "optional", "type": "boolean", "description": "Indicates whether the appointment times sent in the message are in UTC. By default, FourKites assumes the times are in the local time of the stop" }, { "name": "customer", "kind": "optional", "type": "object", "description": "It indicates the customer information for the stop. (CM)", "children": [ { "name": "id", "kind": "optional", "type": "string", "description": "It is the unique identifier of the shipper's customer. The customer should have been created in FourKites before associating it to a load's stop. (CM)" }, { "name": "poNumbers", "kind": "optional", "type": "array", "description": "It indicates the list of Customer PO Numbers associated with the load's stop. (CM)" }, { "name": "pointOfContact", "kind": "optional", "type": "object", "description": "It indicates the point of contact (POC) information at the stop, capturing name, email, phone number, and whether they should be alerted. You can send up to 5 POCs objects per stop.", "children": [ { "name": "email", "kind": "optional", "type": "string", "description": "It indicates the email address of the point of contact at the stop." }, { "name": "phone", "kind": "optional", "type": "string", "description": "It indicates the phone number of the point of contact at the stop. The ISD code followed by mobile number prepended with \"+\" and no special characters." } ] } ] }, { "name": "earliestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the earliest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the earliestAppointmentTime is sent, then the latestAppointmentTime must also be sent." }, { "name": "latestAppointmentTime", "kind": "required", "type": "string", "description": "It indicates the latest scheduled arrival time at the stop in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the latestAppointmentTime is sent, then the earliestAppointmentTime must also be sent. latestAppointmentTime should be greater than or equal to earliestAppointmentTime." }, { "name": "earliestWantTime", "kind": "optional", "type": "string", "description": "It indicates the earliest time by which the load must be delivered to the consignee in the stop's local timezone in ISO 8601 format. (CM)" }, { "name": "latestWantTime", "kind": "optional", "type": "string", "description": "It indicates the latest time by which the load must be delivered to the consignee in the stop's local timezone in ISO 8601 format. ISO 8601 format. If the latestWantTime is sent, then the earliestWantTime must also be sent. (CM)" }, { "name": "pallets", "kind": "optional", "type": "object", "description": "It indicates the list of pallets to be delivered at the stop. Each pallet has a pallet number and list of parts.", "children": [ { "name": "parts", "kind": "optional", "type": "object", "description": "It indicates the list of parts in the pallet.", "children": [ { "name": "quantity", "kind": "optional", "type": "string", "description": "It indicates the quantity of the part." }, { "name": "shipperPartNumber", "kind": "optional", "type": "string", "description": "It indicates the shipper/manufacturer’s part number." }, { "name": "weight", "kind": "optional", "type": "string", "description": "It indicates the weight of the part." } ] } ] } ] }, { "name": "simultaneousTrackingSequenceNumber", "kind": "optional", "type": "string", "description": "This parameter will allow Shippers and Carriers to provide the sequence number to order the delivery sequence to calculate better ETAs. \n\nThe earlier logic would consider either the shortest distance or the Appointment time to sequence the stops for ETA calculation.\n\nThe new logic will look like this:\n- If the Simultaneous tracking Sequence number is provided, this will be given the first priority.\n- If not, then use the existing logic." } ] } ], "formDataParameters": [] }, "currentNewParameter": { "label": "Body Parameter", "value": "bodyDataParameters" }, "hasTryItOut": false, "autoGeneratedAnchorSlug": "staging", "legacyHash": "YL28374pMhUX0Q2TA_y4_" } ``` :::