API Use Case Examples

SOLAS VGM
BoxTech allows shippers, carriers, terminals, depots, and other supply chain participants to instantly obtain technical information about containers, such as tare weight, size/type and maximum gross mass. BoxTech means a one-stop-shop to obtain container tare weights for use in Method 2 SOLAS VGM calculations.
To obtain the tare weight for a given containers you would use the GET method below to retrieve the container detail and would look for the tare_kg in the response, you can now use this in your SOLAS VGM method 2 calculations
Terminal Process
BoxTech allows shippers, carriers, terminals, depots, and other supply chain participants to instantly obtain technical information about containers, such as tare weight, size/type and maximum gross mass.
BoxTech means a one-stop-shop to obtain container max weights for your automated safety checks within a terminal.
For safety you may want to obtain the max weight for a given container to cross check the weight of a container on arrival at the port or terminal.
To obtain the tare weight for a given containers you would use the GET method below to retrieve the container detail and would look for the max_payload_kg or for the loading process the max_gross_mass_kg in the response
Query the API
get
https://app.bic-boxtech.org/api
/v2.0/container/:container
GET Container Detail
Retrieve the Tare Weight from Response
Look for the `tare_kg` in the json response, you can now use this value in your SOLAS VGM method 2 calculations.
[
    {
        "uploaderaccountname": "CANADIAN ROYALTIES INC",
        "bic_code": "NNCU",
        "check_digit": "0",
        "checkDigitwarning": false,
        "codeholder": "CANADIAN ROYALTIES INC",
        "code_holder": "CANADIAN ROYALTIES INC",
        "container_number": "NNCU1000180",
        "csc_approval": "F/BV/7345/00",
        "cubic_capacity_cbm": 33.0,
        "cubic_capacity_cuft": 1172,
        "customs_approval": null,
        "current_operator": null,
        "customs_approval_type": "KB20-DC-73R1",
        "detail_st": "20G1",
        "door_opening_height_mm": null,
        "door_opening_height_ft": null,
        "door_opening_width_mm": 2340,
        "door_opening_width_ft": 7.6721,
        "equipment_identifier": "U",
        "external_height_mm": 2600,
        "external_height_ft": 7.9987,
        "external_length_mm": 6060,
        "external_length_ft": 19.8753,
        "external_width_mm": 2440,
        "external_width_ft": 7.9987,
        "group_st": "20GP",
        "internal_height_mm": 2390,
        "internal_height_ft": 7.8361,
        "internal_length_mm": 5900,
        "internal_length_ft": 19.3443,
        "internal_width_mm": 2350,
        "internal_width_ft": 7.7049,
        "manufacture_date": "2000-10-01",
        "manufacture_number": "CR00-28940",
        "manufacturer": "Cronos Containers",
        "max_gross_mass_kg": 30480,
        "max_gross_mass_lbs": 67197,
        "max_payload_kg": 28130,
        "max_payload_lbs": 62016,
        "one_door_off_end_wall_strength_kg": 15000,
        "one_door_off_end_wall_strength_lbs": 35000,
        "one_door_off_racking_kg": 10000,
        "one_door_off_racking_lbs": 25000,
        "one_door_off_racking_n": 60000,
        "one_door_off_stacking_kg": 70000,
        "one_door_off_stacking_lbs": 140000,
        "prefix": "NNC",
        "racking_kg": 15240,
        "racking_lbs": 33528,
        "racking_n": null,
        "serial_number": "100018",
        "stacking_kg": 213000,
        "stacking_lbs": 430000,
        "tare_kg": 2280,
        "tare_lbs": 5016,
        "timber_treatment_approval": "IM/BASILEUM SI-84/00",
        "capacity_litres": null,
        "imdg_code": null,
        "adr_rid_code": null,
        "baffles": null,
        "smart_container": null,
        "smart_container_certification": null,
        "smart_container_activated": null
    }
]
Last modified 1mo ago