Supported Formats

json

GET /api/v1/packing_list_items/:reference_number.json

Returns the packing list item

Supported Formats

json

Errors

Code Description
400 Bad Request.
404 Not Found.
422 Unprocessable Entity.
500 Internal Server Error.

Examples

curl "https://app.octopi.co/api/v1/packing_list_items/:reference_number.json" -H "Accept: application/json" -H "Content-Type: application/json" -H "Authorization: Token token=YOURTOKEN"
Returned payload:

{
   "packing_list_item" : {
      "shipping_marks" : "123123 1231 312",
      "destination_code": "WOHO",
      "items_at_terminal_destination_count": 2,
      "items_at_terminal_count": 2,
      "items_delivered_count": 0,
      "reference_number" : "DO1231",
      "weight" : 100,
      "consignee_address" : "123 Rue due centre",
      "dock_receipt_number" : "DR1",
      "description" : "10 Drum of Rum",
      "quantity" : 10,
      "stripped_quantity": "9",
      "container" : {
         "number" : "KOSU2200161"
      },
      "consignee" : {
         "name" : "MARENCO LTD"
      },
      "bill_of_lading" : {
         "number" : "TEST123"
      },
      "volume" : 100,
      "package_type" : {
         "code" : "1A",
         "description" : "drum"
      },
      "has_been_stripped": true,
      "has_been_delivered": false,
      "cargoes": [
        {
          ....,
          "description": "Wood",
          "current_location_arrived_at": "2018-01-26T02:08:00Z",
          "current_location_type": "YardArea",
          "current_location": "SHED4",
          "current_location_code": "WOHO",
          ...
        },
        {
          ....,
          "description": "More Wood",
          "current_location_arrived_at": "2018-01-26T02:08:00Z",
          "current_location_type": "YardArea",
          "current_location": "SHED4",
          "current_location_code": "WOHO",
          ...
        }
      ]
   }
}

Params

Param name Description
reference_number
required

Validations:

  • Must be a String


POST /api/v1/packing_list_items.json

Supported Formats

json

Errors

Code Description
400 Bad Request.
404 Not Found.
422 Unprocessable Entity.
500 Internal Server Error.

Examples

curl "https://app.octopi.co/api/v1/packing_list_items.json'" -d '{ "client_identifier": "Test 123", "bill_of_lading_number": "KODA123", "consignee_name": "1 DANS AUTO RECYCLING", "packing_list_item": { "reference_number": "GAF0012345", "quantity": 5, "weight": 100.00, "volume": 45.00, "description": "TEXT", "consignee_address": "123 St. 21122", "shipping_marks": "15155", "dock_receipt_number": "ABC12312", "package_type": "4A", "destination_code": "BBB-123", "extra_attributes": { "over_stripped": "6.0" } } }' -X POST -H "Accept: application/json" -H "Content-Type: application/json" -H "Authorization: Token token=ADD TOKEN HERE"
Returned Payload:
{
  "packing_list_item": {
    "reference_number": "GAF0012345",
    "destination_code": "BBB-123",
    "bill_of_lading": {
      "number": "KODA123"
    },
    "container": {
      "number": "BSIU9792565",
      "client_identifier": null
    },
    "consignee": {
      "name": "1 DANS AUTO RECYCLING"
    },
    "quantity": 5,
    "weight": 45.359237,
    "volume": 45.0,
    "package_type": {
      "code": "4A",
      "description": null
    },
    "description": "TEXT",
    "consignee_address": "123 St. 21122",
    "shipping_marks": "15155",
    "dock_receipt_number": "ABC12312",
    "extra_attributes": {
      "over_stripped": "6.0"
    }
  }
}

Params

Param name Description
packing_list_item
optional

Validations:

  • Must be a Hash

packing_list_item[reference_number]
optional

Validations:

  • Must be a String

packing_list_item[quantity]
optional

Validations:

  • Must be a Integer

packing_list_item[weight]
optional

Validations:

  • Must be a Float

packing_list_item[volume]
optional

Validations:

  • Must be a Float

packing_list_item[description]
optional

Validations:

  • Must be a String

packing_list_item[consignee_address]
optional

Validations:

  • Must be a String

packing_list_item[shipping_marks]
optional

Validations:

  • Must be a String

packing_list_item[dock_receipt_number]
optional

Validations:

  • Must be a String

bill_of_lading_number
required

Validations:

  • Must be a String

consignee_name
required

Validations:

  • Must be a String

packing_list_id
optional

The packing list’s ID. If unavailable, please ensure you provide a client identifier.

Validations:

  • Must be a String

client_identifier
optional

The packing list’s client idenfitier. If unavailable, please ensure you provide a packing list ID.

Validations:

  • Must be a String

container_client_identifier
optional

Validations:

  • Must be a String


PATCH /api/v1/packing_list_items/:reference_number.json

Supported Formats

json

Errors

Code Description
400 Bad Request.
404 Not Found.
422 Unprocessable Entity.
500 Internal Server Error.

Examples

curl "https://app.octopi.co/api/v1/packing_list_items/:reference_number.json'" -X PATCH -H "Accept: application/json" -H "Content-Type: application/json" -H "Authorization: Token token=ADD TOKEN HERE -d '{ "packing_list_item": { "package_type": "box", "extra_attributes": { "foo": "bar" }, "quantity": 5 } }'"
Returned payload:
{
  "packing_list_item": {
    "reference_number": "01234",
    "destination_code": "BBB123",
    "items_at_terminal_destination_count": 0,
    "items_at_terminal_count": 0,
    "items_delivered_count": 0,
    "bill_of_lading": {
      "number": "TEST123"
    },
    "container": {
      "number": "BSIU1234567",
      "client_identifier": null,
      "status": "full",
      "delivery_type": null,
      "container_type": {
        "code": "40HC",
        "description": "",
        "iso_type_code": "45G1"
      }
    },
    "consignee": {
      "name": "DAN'S AUTO RECYCLING"
    },
    "agent": {
      "name": null
    },
    "vessel": {
      "name": null
    },
    "voyage": {
      "number": null
    },
    "quantity": 5,
    "weight": 45.359237,
    "volume": 45.0,
    "package_type": {
      "code": "4A",
      "description": "box"
    },
    "description": "Many things in here",
    "consignee_address": "123 St. 21122",
    "shipping_marks": "15155",
    "dock_receipt_number": "ABC12312",
    "extra_attributes": {
      "foo": "bar"
    },
    "has_been_stripped": false,
    "has_been_delivered": false,
    "stripped_quantity": 0,
    "cargoes": []
  }
}

Params

Param name Description
packing_list_item
required

Validations:

  • Must be a Hash

packing_list_item[reference_number]
required

The reference number for this packing list item.

Validations:

  • Must be a String

packing_list_item[consignee]
optional

The consignee for this packing list item.

Validations:

  • Must be a String

packing_list_item[description]
optional

The goods description for this packing list item.

Validations:

  • Must be a String

packing_list_item[extra_attributes]
optional

Extra attributes for this packing list item.

Validations:

  • Must be a Hash

packing_list_item[package_type]
optional

The package type or package type code (eg. “box” or “4A”) of this packing list item.

Validations:

  • Must be a String

packing_list_item[package_weight]
optional

The package weight of this packing list item.

Validations:

  • Must be a decimal number.

packing_list_item[quantity]
optional

The quantity of this packing list item.

Validations:

  • Must be a number.


DELETE /api/v1/packing_list_items/:reference_number.json

Supported Formats

json

Errors

Code Description
400 Bad Request.
404 Not Found.
422 Unprocessable Entity.
500 Internal Server Error.

Examples

curl "https://app.octopi.co/api/v1/packing_list_items/:reference_number.json'" -X DELETE -H "Accept: application/json" -H "Content-Type: application/json" -H "Authorization: Token token=ADD TOKEN HERE"

Params

Param name Description
reference_number
required

Validations:

  • Must be a String