Skip to main content
Manage port base rates with tiered pricing based on cargo volume (CBM).

GET - List Port Base Rates

Retrieves all port base rate records.

Response

id
integer
Unique identifier for the rate record
region
string
Geographic region
country
string
Country name
port_of_loading
string
Port of loading name
rate_0_3_cbm
number
Rate for 0-3 CBM shipments
rate_3_5_cbm
number
Rate for 3-5 CBM shipments
rate_5_10_cbm
number
Rate for 5-10 CBM shipments
rate_10_15_cbm
number
Rate for 10-15 CBM shipments
gri
string
General Rate Increase information (optional)
minimum
number
Minimum charge (optional)
via
string
Transit route (optional)
currency
string
Currency (ARS, USD, or EUR)
transit_time
string
Expected transit time (optional)
valid_from
string
Start date of validity
valid_until
string
End date of validity
created_at
string
Creation timestamp
updated_at
string
Last update timestamp

Request Example

cURL
curl -X GET https://api.iclcotizaciones.com/api/tarifario-puertos-base \
  -H "Cookie: session=your_session_token"

Response Example

200
[
  {
    "id": 1,
    "region": "Asia",
    "country": "China",
    "port_of_loading": "Shanghai",
    "rate_0_3_cbm": 180.0,
    "rate_3_5_cbm": 165.0,
    "rate_5_10_cbm": 150.0,
    "rate_10_15_cbm": 140.0,
    "gri": "GRI +50 from March 2024",
    "minimum": 300.0,
    "via": "Buenos Aires",
    "currency": "USD",
    "transit_time": "45-50 days",
    "valid_from": "2024-01-01",
    "valid_until": "2024-06-30",
    "created_at": "2024-01-01T00:00:00Z",
    "updated_at": "2024-01-01T00:00:00Z"
  }
]
401
{
  "error": "No autorizado"
}

POST - Create Port Base Rate

Creates a new port base rate record. This endpoint requires admin permissions.
Admin Only: Only users with admin roles (DIRECTOR, GERENTE) can create port base rates.

Request Body

region
string
required
Geographic region
country
string
required
Country name
port_of_loading
string
required
Port of loading name
rate_0_3_cbm
number
required
Rate for 0-3 CBM shipments
rate_3_5_cbm
number
required
Rate for 3-5 CBM shipments
rate_5_10_cbm
number
required
Rate for 5-10 CBM shipments
rate_10_15_cbm
number
required
Rate for 10-15 CBM shipments
gri
string
General Rate Increase information
minimum
number
Minimum charge
via
string
Transit route
currency
string
default:"USD"
Currency (ARS, USD, or EUR)
transit_time
string
Expected transit time
valid_from
string
required
Start date of validity (YYYY-MM-DD)
valid_until
string
required
End date of validity (YYYY-MM-DD)

Request Example

cURL
curl -X POST https://api.iclcotizaciones.com/api/tarifario-puertos-base \
  -H "Cookie: session=your_session_token" \
  -H "Content-Type: application/json" \
  -d '{
    "region": "Asia",
    "country": "China",
    "port_of_loading": "Ningbo",
    "rate_0_3_cbm": 175.0,
    "rate_3_5_cbm": 160.0,
    "rate_5_10_cbm": 145.0,
    "rate_10_15_cbm": 135.0,
    "gri": "No GRI currently",
    "minimum": 280.0,
    "via": "Buenos Aires",
    "currency": "USD",
    "transit_time": "40-45 days",
    "valid_from": "2024-03-01",
    "valid_until": "2024-08-31"
  }'

Response Example

201
{
  "id": 28,
  "region": "Asia",
  "country": "China",
  "port_of_loading": "Ningbo",
  "rate_0_3_cbm": 175.0,
  "rate_3_5_cbm": 160.0,
  "rate_5_10_cbm": 145.0,
  "rate_10_15_cbm": 135.0,
  "gri": "No GRI currently",
  "minimum": 280.0,
  "via": "Buenos Aires",
  "currency": "USD",
  "transit_time": "40-45 days",
  "valid_from": "2024-03-01",
  "valid_until": "2024-08-31",
  "created_at": "2024-03-04T16:45:00Z",
  "updated_at": "2024-03-04T16:45:00Z"
}
403
{
  "error": "No autorizado"
}

PUT - Update Port Base Rate

Updates an existing port base rate record by ID. This endpoint requires admin permissions.
Admin Only: Only users with admin roles (DIRECTOR, GERENTE, ADMINISTRACION) can update port rate records.

Path Parameters

id
integer
required
The unique identifier of the port rate record to update

Request Body

All fields from POST are supported.
region
string
required
Geographic region
country
string
required
Country name
port_of_loading
string
required
Port of loading name
rate_0_3_cbm
number
required
Rate per CBM for shipments 0-3 CBM
rate_3_5_cbm
number
required
Rate per CBM for shipments 3-5 CBM
rate_5_10_cbm
number
required
Rate per CBM for shipments 5-10 CBM
rate_10_15_cbm
number
required
Rate per CBM for shipments 10-15 CBM
gri
string
General Rate Increase information
minimum
number
Minimum charge amount
via
string
Via port or transit location
currency
string
default:"USD"
Currency (USD, EUR, or ARS)
transit_time
string
Estimated transit time
valid_from
string
required
Start date of validity (YYYY-MM-DD)
valid_until
string
required
End date of validity (YYYY-MM-DD)

Request Example

cURL
curl -X PUT https://api.iclcotizaciones.com/api/tarifario-puertos-base/28 \
  -H "Cookie: session=your_session_token" \
  -H "Content-Type: application/json" \
  -d '{
    "region": "Asia",
    "country": "China",
    "port_of_loading": "Ningbo",
    "rate_0_3_cbm": 180.0,
    "rate_3_5_cbm": 165.0,
    "rate_5_10_cbm": 150.0,
    "rate_10_15_cbm": 140.0,
    "gri": "GRI $100 effective April 1",
    "minimum": 290.0,
    "via": "Buenos Aires",
    "currency": "USD",
    "transit_time": "38-42 days",
    "valid_from": "2024-04-01",
    "valid_until": "2024-09-30"
  }'

Response Example

200
{
  "id": 28,
  "region": "Asia",
  "country": "China",
  "port_of_loading": "Ningbo",
  "rate_0_3_cbm": 180.0,
  "rate_3_5_cbm": 165.0,
  "rate_5_10_cbm": 150.0,
  "rate_10_15_cbm": 140.0,
  "gri": "GRI $100 effective April 1",
  "minimum": 290.0,
  "via": "Buenos Aires",
  "currency": "USD",
  "transit_time": "38-42 days",
  "valid_from": "2024-04-01",
  "valid_until": "2024-09-30",
  "created_at": "2024-03-04T16:45:00Z",
  "updated_at": "2024-03-04T19:00:00Z"
}
403
{
  "error": "No autorizado"
}

DELETE - Delete Port Base Rate

Deletes a port base rate record by ID. This endpoint requires admin permissions.
Admin Only: Only users with admin roles (DIRECTOR, GERENTE, ADMINISTRACION) can delete port rate records. This is a hard delete and cannot be undone.

Path Parameters

id
integer
required
The unique identifier of the port rate record to delete

Request Example

cURL
curl -X DELETE https://api.iclcotizaciones.com/api/tarifario-puertos-base/28 \
  -H "Cookie: session=your_session_token"

Response Example

200
{
  "ok": true
}
403
{
  "error": "No autorizado"
}

Build docs developers (and LLMs) love