Cello Square - Logistics Service
Cello Square - Logistics Service · GPT アクション
GPTs interaction API for Cello Square Logistics Service.
The API provides an interface between GPT and Cello Square. It's designed to offer Cello Square's services with GPT based on user needs, including quotation, logistics tracking and loading optimizer.
GET /gpts/loginloginGET /gpts/ports/oceanRetrieve available ports for ocean(해상) logistics service.Retrieve a list of available types of ports (해상서비스, 항구) (origin, destination) for logistics. Must have the value 'origin_port' when 'type': 'destination'.
GET /gpts/ports/airRetrieve available ports for air(항공) logistics service.Retrieve a list of available types of airports (항공서비스, 공항) (origin, destination) for logistics. Must have the value 'origin_port' when 'type': 'destination'.
GET /gpts/ports/expressRetrieve available ports for express(특송) logistics service.Retrieve a list of available types of ports (특송서비스, 국가) (origin, destination) for logistics. Must have the value 'origin_port' when 'type': 'destination'.
GET /gpts/ports/truckRetrieve available ports for truck(트럭) logistics service.Retrieve a list of available types of ports (트럭 운송 서비스, 항구) (origin, destination) for logistics. Must have the value 'origin_port' when 'type': 'destination'.
POST /gpts/simple-quotes/oceanObtain ocean(해상) freight quotes based on selected conditions.Get competitive ocean(해상) freight quotes based on your shipping criteria. You must explicitly ask the user to select a nation. This nation refers to where your business is situated and where the billing occurs.
POST /gpts/simple-quotes/airObtain air(항공) freight quotes based on selected conditions.Secure the best air(항공) freight rates and routes for your shipments, ensuring timely and safe deliveries. You must explicitly ask the user to select a nation. This nation does not pertain to the shipment's origin. It refers to the country where your business is situated and where the billing occurs.
POST /gpts/simple-quotes/expressObtain express(특송) freight quotes based on selected conditions.Receive express(특송) freight quotes for urgent shipments. You must explicitly ask the user to select a nation. This nation refers to where your business is situated and where the billing occurs.
POST /gpts/simple-quotes/truckObtain truck(트럭 서비스) freight quotes based on selected conditions.Receive truck(트럭 운송) freight quotes for urgent shipments. You must explicitly ask the user to select a nation. This nation refers to where your business is situated and where the billing occurs.
GET /gpts/tracking-info/{HBLNo}Get tracking information by HBLNo.Retrieve detailed tracking information using a specific HBLNo. Inform how and where the goods being transported have moved. Deliver tracking information and provide URLs and images that allow you to visually check detailed information.
POST /gpts/loading-optimizer/executionExecute or simulate to load items into containers using a 3D simulation engine.Simulates loading items into trucks, pallets, and containers, providing 3D results. It requires 'tloOrdrItem' and 'tloOrdrCntr' fields, with item specifics like quantity, width, length, height. If 'quantity' or 'layer' in 'tloOrdrItem' is unknown, input 'none'.
GET /gpts/version-infoGet version and features of API.Retrieve version and features of this API.
元の API スキーマ
{
"openapi": "3.1.0",
"info": {
"title": "GPTs interaction API for Cello Square Logistics Service.",
"description": "The API provides an interface between GPT and Cello Square.\nIt's designed to offer Cello Square's services with GPT based on user needs,\nincluding quotation, logistics tracking and loading optimizer.",
"version": "2.7.1"
},
"servers": [
{
"url": "https://wwwlk.kr"
}
],
"security": [
{
"ApiKeyAuth": []
}
],
"components": {
"securitySchemes": {
"ApiKeyAuth": {
"type": "apiKey",
"in": "header",
"name": "x-api-key"
}
},
"schemas": {
"SimpleQuoteAirRequest": {
"type": "object",
"properties": {
"nation": {
"type": "string",
"description": "Required. The nation in which your business is located and billing. (This is information that must be selected separately regardless of origin/destination.) The units and currency shown in your quote are in your country's units and currency. Never choose yourself, you should explicitly ask the user to enter the selected country.",
"enum": [
"CA",
"CN",
"EG",
"DE",
"IN",
"IT",
"KR",
"MY",
"NL",
"PA",
"PE",
"SG",
"TH",
"TR",
"AE",
"US",
"VN"
]
},
"origin_port": {
"type": "string",
"pattern": "^[a-zA-Z0-9]{3}$",
"description": "Origin airport IATA code in 3-character format (e.g., LAX, JFK)."
},
"destination_port": {
"type": "string",
"pattern": "^[a-zA-Z0-9]{3}$",
"description": "Destination airport IATA code in 3-character format (e.g., LAX, JFK)."
},
"cargo_weight": {
"type": "string",
"pattern": "^\\d+$",
"description": "Weight (kg) of cargo."
}
},
"required": [
"nation",
"origin_port",
"destination_port",
"cargo_weight"
]
},
"SimpleQuoteOceanRequest": {
"type": "object",
"properties": {
"nation": {
"type": "string",
"description": "Required. The nation in which your business is located and billing. (This is information that must be selected separately regardless of origin/destination.) The units and currency shown in your quote are in your country's units and currency. Never choose yourself, you should explicitly ask the user to enter the selected country.",
"enum": [
"AU",
"BR",
"CA",
"CL",
"CN",
"CO",
"EG",
"FR",
"DE",
"HU",
"IN",
"IT",
"KR",
"MY",
"MX",
"NL",
"PA",
"PE",
"PL",
"SG",
"SK",
"ZA",
"ES",
"SE",
"TH",
"TR",
"AE",
"GB",
"US",
"VN"
]
},
"load_type": {
"type": "string",
"enum": [
"FCL",
"LCL"
],
"description": "Load type, Must be one of 'FCL' or 'LCL'."
},
"origin_port": {
"type": "string",
"pattern": "^[a-zA-Z0-9]{5}$",
"description": "Origin port in UN/LOCODE format (5-characters)."
},
"destination_port": {
"type": "string",
"pattern": "^[a-zA-Z0-9]{5}$",
"description": "Destination port in UN/LOCODE format (5-characters)."
},
"container_type": {
"type": "string",
"enum": [
"20ND",
"40ND",
"40HQ",
"20 Dry Container",
"40 Dry Container",
"40 High Cube Container"
],
"description": "Container type, required when load_type is 'FCL'."
},
"cargo_quantity": {
"type": "string",
"pattern": "^\\d+$",
"description": "If load_type is FCL, specify container amount. If load_type is LCL, specify number of CBM (Width x Length x Height). Do not Enter arbitrary amount or CBM."
}
},
"required": [
"nation",
"load_type",
"origin_port",
"destination_port",
"cargo_quantity"
]
},
"SimpleQuoteExpressRequest": {
"type": "object",
"properties": {
"nation": {
"type": "string",
"description": "Required. The nation in which your business is located and billing. The units and currency shown in your quote are in your country's units and currency. Never choose yourself, you should explicitly ask the user to enter the selected country.",
"enum": [
"KR"
]
},
"origin_port": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Country code format for origin port (e.g., KR).",
"enum": [
"KR"
]
},
"destination_port": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Country code format for destination port (e.g., US, CA)."
},
"cargo_weight": {
"type": "string",
"pattern": "^\\d+$",
"description": "Weight (kg) of cargo."
}
},
"required": [
"nation",
"origin_port",
"destination_port",
"cargo_weight"
]
},
"SimpleQuoteTruckRequest": {
"type": "object",
"properties": {
"nation": {
"description": "Required. The nation in which your business is located and billing. (This is information that must be selected separately regardless of origin/destination.) The units and currency shown in your quote are in your country's units and currency. Never choose yourself, you should explicitly ask the user to enter the selected country.",
"type": "string",
"enum": [
"CA",
"MX",
"ZA",
"TH",
"TR",
"AE",
"US"
]
},
"origin_port": {
"description": "Origin port in UN/LOCODE format (5-characters).",
"type": "string",
"pattern": "^[A-Z]{5}$"
},
"destination_port": {
"description": "Destination port in UN/LOCODE format (5-characters).",
"type": "string",
"pattern": "^[A-Z]{5}$"
},
"cargo": {
"type": "object",
"properties": {
"cargo_type": {
"description": "Required. The type of cargo based on the selected nation:\n- CA (Canada): 53'FT\n- MX (Mexico): 53'FT\n- ZA (South Africa): 32Ton\n- TH (Thailand): 20' Dry, 40' Dry, 40' HC\n- TR (Turkey): 24Ton\n- AE (United Arab Emirates): 13.5M\n- US (United States): 53'FT\n\nPlease ensure to select a valid cargo type for the chosen nation. If an invalid type is selected, the request will not be processed.",
"type": "string",
"enum": [
"53FT",
"32Ton",
"24Ton",
"20Dry",
"40Dry",
"40HC",
"13.5M"
]
},
"cargo_amount": {
"description": "The amount(number) of cargo to be transported. Please enter an integer value.",
"type": "string"
}
},
"required": [
"nation",
"origin_port",
"destination_port",
"cargo"
]
}
}
},
"LoadingOptimizerRequest": {
"type": "object",
"properties": {
"tloOrdrItem": {
"type": "array",
"items": {
"type": "object",
"properties": {
"quantity": {
"type": "string",
"description": "If not entered, set 'none'. The API calculates the required quantity and returns the result."
},
"width": {
"type": "number",
"description": "Item width. It must be greater than 0."
},
"length": {
"type": "number",
"description": "Item length. It must be greater than 0."
},
"height": {
"type": "number",
"description": "Item height. It must be greater than 0."
},
"unit": {
"type": "string",
"description": "Length units for the item's width, length, and height. The default value is mm.",
"enum": [
"m",
"cm",
"mm"
]
},
"weight": {
"type": "number",
"description": "If not sure how much to enter, enter 0 as the default. This value means item weight and unit is kg."
},
"direction": {
"type": "string",
"description": "In general, the direction of width, length, and height is 'stand', but if it is laid down or rotated, it is 'rotated'.",
"enum": [
"stand",
"rotated"
]
},
"layer": {
"type": "string",
"description": "If not entered, set 'none'. Adjust this value when you want to stack boxes in k layers."
}
},
"required": [
"width",
"length",
"height",
"unit"
]
}
},
"tloOrdrCntr": {
"type": "object",
"properties": {
"containerType": {
"type": "string",
"description": "There are three types of containers (Truck, Container, Pallet) for loading items. Default value is 20 Cargo Container. The numbers in the name of each type mean ft for container and cm for pallet and ton for truck. Trucks have different specifications depending on the country, and are classified into Truck, Van, and Trailer.",
"enum": [
"1 Ton Truck",
"2.5 Ton Truck",
"3.5 Ton Truck",
"5 Ton Truck",
"11 Ton Wing Body Truck",
"North America Standard Dry Van",
"North America Pup Trailer",
"North America High Cube Dry Van",
"North America Flatbed Truck",
"North America Standard Refrigerated Truck",
"North America Small Refrigerated Van",
"North America High Cube Refrigerated Truck",
"European Union Curtain Sider",
"European Union Box Truck",
"European Union Standard Refrigerated Truck",
"European Union Small Refrigerated Van",
"European Union High Cube Refrigerated Truck",
"European Union Standard Trailer",
"European Union Mega Trailer",
"European Union City Trailer",
"European Union Double-Deck Trailer",
"20 Dry Container",
"40 Dry Container",
"40 High Cube Container",
"45 High Cube Container",
"20 Reefer Container",
"40 Reefer Container",
"40 High Cube Reefer Container",
"20 Open Top Container",
"40 Open Top Container",
"20 Flat Rack Container",
"40 Flat Rack Container",
"80x80 Pallet",
"80x100 Pallet",
"110x110 Pallet"
]
}
},
"required": [
"containerType"
]
}
},
"required": [
"tloOrdrItem",
"tloOrdrCntr"
]
}
}
},
"paths": {
"/gpts/login": {
"get": {
"operationId": "login",
"parameters": [
{
"name": "user_id",
"in": "query",
"description": "Required. The property that selects whether to get a list of origins or destinations.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "password",
"in": "query",
"description": "Required. The property that selects whether to get a list of origins or destinations.",
"required": true,
"schema": {
"type": "string"
}
}
]
}
},
"/gpts/ports/ocean": {
"get": {
"operationId": "get_ports_ocean",
"x-openai-isConsequential": false,
"summary": "Retrieve available ports for ocean(해상) logistics service.",
"description": "Retrieve a list of available types of ports (해상서비스, 항구) (origin, destination) for logistics. Must have the value 'origin_port' when 'type': 'destination'.",
"tags": [
"Port"
],
"parameters": [
{
"name": "nation",
"in": "query",
"description": "Required. The nation in which your business is located and billing. (This is information that must be selected separately regardless of origin/destination.) The units and currency shown in your quote are in your country's units and currency. Never choose yourself, you should explicitly ask the user to enter the selected country.",
"required": true,
"schema": {
"type": "string",
"enum": [
"AU(Australia)",
"BR(Brazil)",
"CA(Canada)",
"CL(Chile)",
"CN(China)",
"CO(Colombia)",
"EG(Egypt)",
"FR(France)",
"DE(Germany)",
"HU(Hungary)",
"IN(India)",
"IT(Italy)",
"KR(Korea)",
"MY(Malaysia)",
"MX(Mexico)",
"NL(Netherlands)",
"PA(Panama)",
"PE(Peru)",
"PL(Poland)",
"SG(Singapore)",
"SK(Slovakia)",
"ZA(South Africa)",
"ES(Spain)",
"SE(Sweden)",
"TH(Thailand)",
"TR(Turkiye)",
"AE(UAE)",
"GB(United Kingdom)",
"US(United States)",
"VN(Vietnam)"
]
}
},
{
"name": "type",
"in": "query",
"description": "Required. The property that selects whether to get a list of origins or a list of possible destinations based on origin. 'origin': list of origins, 'destination': list of destinations.",
"required": true,
"schema": {
"type": "string",
"enum": [
"origin",
"destination"
]
}
},
{
"name": "load_type",
"in": "query",
"description": "Must be one of FCL or LCL.",
"required": true,
"schema": {
"type": "string",
"enum": [
"FCL",
"LCL"
]
}
},
{
"name": "origin_port",
"in": "query",
"description": "Required when 'type': 'destination'. Selected Origin port in UN/LOCODE format (5-characters).",
"schema": {
"type": "string",
"pattern": "^[a-zA-Z0-9]{5}$"
}
},
{
"name": "destination_port",
"in": "query",
"description": "Selected Destination port in UN/LOCODE format (5-characters).",
"schema": {
"type": "string",
"pattern": "^[a-zA-Z0-9]{5}$"
}
}
]
}
},
"/gpts/ports/air": {
"get": {
"operationId": "get_ports_air",
"x-openai-isConsequential": false,
"summary": "Retrieve available ports for air(항공) logistics service.",
"description": "Retrieve a list of available types of airports (항공서비스, 공항) (origin, destination) for logistics. Must have the value 'origin_port' when 'type': 'destination'.",
"tags": [
"Port"
],
"parameters": [
{
"name": "nation",
"in": "query",
"description": "Required. The nation in which your business is located and billing. (This is information that must be selected separately regardless of origin/destination.) The units and currency shown in your quote are in your country's units and currency. Never choose yourself, you should explicitly ask the user to enter the selected country.",
"required": true,
"schema": {
"type": "string",
"enum": [
"CA(Canada)",
"CN(China)",
"EG(Egypt)",
"DE(Germany)",
"IN(India)",
"IT(Italy)",
"KR(Korea)",
"MY(Malaysia)",
"NL(Netherlands)",
"PA(Panama)",
"PE(Peru)",
"SG(Singapore)",
"TH(Thailand)",
"TR(Turkiye)",
"AE(UAE)",
"US(United States)",
"VN(Vietnam)"
]
}
},
{
"name": "type",
"in": "query",
"description": "Required. The property that selects whether to get a list of origins or destinations.",
"required": true,
"schema": {
"type": "string",
"enum": [
"origin",
"destination"
]
}
},
{
"name": "origin_port",
"in": "query",
"description": "Required when 'type': 'destination'. Selected Origin port in airport code format (3-characters).",
"schema": {
"type": "string",
"pattern": "^[a-zA-Z0-9]{3}$"
}
},
{
"name": "destination_port",
"in": "query",
"description": "Selected Destination port in airport code format (3-characters).",
"schema": {
"type": "string",
"pattern": "^[a-zA-Z0-9]{3}$"
}
}
]
}
},
"/gpts/ports/express": {
"get": {
"operationId": "get_ports_express",
"x-openai-isConsequential": false,
"summary": "Retrieve available ports for express(특송) logistics service.",
"description": "Retrieve a list of available types of ports (특송서비스, 국가) (origin, destination) for logistics. Must have the value 'origin_port' when 'type': 'destination'.",
"tags": [
"Port"
],
"parameters": [
{
"name": "nation",
"in": "query",
"description": "Required. The nation in which your business is located and billing. (This is information that must be selected separately regardless of origin/destination.) The units and currency shown in your quote are in your country's units and currency. Never choose yourself, you should explicitly ask the user to enter the selected country.",
"required": true,
"schema": {
"type": "string",
"enum": [
"KR(Korea)"
]
}
},
{
"name": "type",
"in": "query",
"description": "Required. The property that selects whether to get a list of origins or destinations.",
"required": true,
"schema": {
"type": "string",
"enum": [
"origin",
"destination"
]
}
},
{
"name": "origin_port",
"in": "query",
"description": "Required when 'type': 'destination'. Selected Origin port in country code format (2-characters).",
"schema": {
"type": "string",
"pattern": "^[a-zA-Z0-9]{2}$"
}
},
{
"name": "destination_port",
"in": "query",
"description": "Selected Destination port in country code format (2-characters).",
"schema": {
"type": "string",
"pattern": "^[a-zA-Z0-9]{2}$"
}
}
]
}
},
"/gpts/ports/truck": {
"get": {
"operationId": "get_ports_truck",
"x-openai-isConsequential": false,
"summary": "Retrieve available ports for truck(트럭) logistics service.",
"description": "Retrieve a list of available types of ports (트럭 운송 서비스, 항구) (origin, destination) for logistics. Must have the value 'origin_port' when 'type': 'destination'.",
"tags": [
"Port"
],
"parameters": [
{
"name": "nation",
"in": "query",
"description": "Required. The nation in which your business is located and billing. (This is information that must be selected separately regardless of origin/destination.) The units and currency shown in your quote are in your country's units and currency. Never choose yourself, you should explicitly ask the user to enter the selected country.",
"required": true,
"schema": {
"type": "string",
"enum": [
"CA(Canada)",
"MX(Mexico)",
"TH(Thailand)",
"TR(Turkiye)",
"AE(UAE)",
"US(United States)",
"ZA(South Africa)"
]
}
},
{
"name": "type",
"in": "query",
"description": "Required. The property that selects whether to get a list of origins or destinations.",
"required": true,
"schema": {
"type": "string",
"enum": [
"origin",
"destination"
]
}
},
{
"name": "origin_port",
"in": "query",
"description": "Required when 'type': 'destination'. Selected Origin port in UN/LOCODE format (5-characters).",
"schema": {
"type": "string",
"pattern": "^[a-zA-Z0-9]{5}$"
}
},
{
"name": "destination_port",
"in": "query",
"description": "Selected Destination port in UN/LOCODE format (5-characters).",
"schema": {
"type": "string",
"pattern": "^[a-zA-Z0-9]{5}$"
}
}
]
}
},
"/gpts/simple-quotes/ocean": {
"post": {
"operationId": "post_simple_quotes_ocean",
"x-openai-isConsequential": false,
"summary": "Obtain ocean(해상) freight quotes based on selected conditions.",
"description": "Get competitive ocean(해상) freight quotes based on your shipping criteria. You must explicitly ask the user to select a nation. This nation refers to where your business is situated and where the billing occurs.",
"tags": [
"Quote"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SimpleQuoteOceanRequest"
}
}
}
}
}
},
"/gpts/simple-quotes/air": {
"post": {
"operationId": "post_simple_quotes_air",
"x-openai-isConsequential": false,
"summary": "Obtain air(항공) freight quotes based on selected conditions.",
"description": "Secure the best air(항공) freight rates and routes for your shipments, ensuring timely and safe deliveries. You must explicitly ask the user to select a nation. This nation does not pertain to the shipment's origin. It refers to the country where your business is situated and where the billing occurs.",
"tags": [
"Quote"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SimpleQuoteAirRequest"
}
}
}
}
}
},
"/gpts/simple-quotes/express": {
"post": {
"operationId": "post_simple_quotes_express",
"x-openai-isConsequential": false,
"summary": "Obtain express(특송) freight quotes based on selected conditions.",
"description": "Receive express(특송) freight quotes for urgent shipments. You must explicitly ask the user to select a nation. This nation refers to where your business is situated and where the billing occurs.",
"tags": [
"Quote"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SimpleQuoteExpressRequest"
}
}
}
}
}
},
"/gpts/simple-quotes/truck": {
"post": {
"operationId": "post_simple_quotes_truck",
"x-openai-isConsequential": false,
"summary": "Obtain truck(트럭 서비스) freight quotes based on selected conditions.",
"description": "Receive truck(트럭 운송) freight quotes for urgent shipments. You must explicitly ask the user to select a nation. This nation refers to where your business is situated and where the billing occurs.",
"tags": [
"Quote"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SimpleQuoteTruckRequest"
}
}
}
}
}
},
"/gpts/tracking-info/{HBLNo}": {
"get": {
"operationId": "get_tracking_info",
"x-openai-isConsequential": false,
"summary": "Get tracking information by HBLNo.",
"description": "Retrieve detailed tracking information using a specific HBLNo. Inform how and where the goods being transported have moved. Deliver tracking information and provide URLs and images that allow you to visually check detailed information.",
"tags": [
"Tracking"
],
"parameters": [
{
"name": "HBLNo",
"in": "path",
"description": "HBL Number to retrieve tracking information.",
"required": true,
"schema": {
"type": "string"
}
}
]
}
},
"/gpts/loading-optimizer/execution": {
"post": {
"operationId": "post_load_simulation_item_container",
"x-openai-isConsequential": false,
"summary": "Execute or simulate to load items into containers using a 3D simulation engine.",
"description": "Simulates loading items into trucks, pallets, and containers, providing 3D results. It requires 'tloOrdrItem' and 'tloOrdrCntr' fields, with item specifics like quantity, width, length, height. If 'quantity' or 'layer' in 'tloOrdrItem' is unknown, input 'none'.",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LoadingOptimizerRequest"
}
}
}
}
}
},
"/gpts/version-info": {
"get": {
"operationId": "get_version_info",
"x-openai-isConsequential": false,
"summary": "Get version and features of API.",
"description": "Retrieve version and features of this API.",
"tags": [
"Version & Features"
]
}
}
}
}