Skip to main content

Enviame API (2.0.0)

Download OpenAPI specification:Download

License: Apache 2.0

General Concepts

In this documentation you will find all the endpoints available in our API. To use them you will need your own Company/Seller ID (id_seller) and its respective API Key. If you are working in Marketplace mode, you will also need the Marketplace ID (marketplace_id) and use its API Key.

  • API Keys can be found in the My Company/Seller or My Marketplace section of the Enviame platform. These endpoints are configured to be used in the stage testing environment, so they use the API Keys and IDs corresponding to that environment. If instead they will be used against the api production environment, the stage subdomain must be removed from the endpoint and the apikey and Company/Seller ID corresponding to that environment must be used.
  • Stage: https://stage.api.enviame.io
  • Production: https://api.enviame.io If you have questions about this documentation, write to us at support@enviame.io

Deliveries

Create delivery as seller

Endpoint that allows creating deliveries for a Company/Seller

path Parameters
id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

header Parameters
api-key
required
string

Company/Seller API Key, generated by Enviame

Accept
required
string
Default: application/json
Content-Type
required
string
Default: application/json
Request Body schema: application/json

Create a new delivery

object
object
object
object
object
Array of objects

Custom additional fields

Responses

Request samples

Content type
application/json
Example
{
  • "shipping_order": {
    },
  • "shipping_origin": {
    },
  • "shipping_destination": {
    },
  • "dimensions": {
    },
  • "carrier": {
    }
}

Response samples

Content type
application/json
Example
Loading...

Create delivery in seller as marketplace

Endpoint that allows creating deliveries in a Company/Seller associated with a Marketplace, using the marketplace's api-key for this purpose

path Parameters
marketplace_id
required
integer <int64>

Marketplace ID, generated by Enviame

id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

header Parameters
api-key
required
string

Marketplace API Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Content-Type
required
string
Default: application/json

Not modified

Request Body schema: application/json

Create a new delivery as MKP

object
object
object
object
object
Array of objects

Responses

Request samples

Content type
application/json
Example
{
  • "shipping_order": {
    },
  • "shipping_origin": {
    },
  • "shipping_destination": {
    },
  • "dimensions": {
    },
  • "carrier": {
    }
}

Response samples

Content type
application/json
Example
Loading...

Transform to multi-package from Seller

Endpoint that allows modifying the number of packages (n_packages) of a delivery already created with the carrier.

path Parameters
delivery_id
required
integer <int64>

Delivery ID, generated by Enviame

id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Request Body schema: application/json

Change packages of a delivery

n_package
integer

Required / Number of packages to transform

Responses

Request samples

Content type
application/json
{
  • "n_package": 3
}

Response samples

Content type
application/json
{}

View delivery

Endpoint that allows viewing the information of a Company/Seller delivery

path Parameters
delivery_id
required
integer <int64>

Delivery ID, generated by Enviame

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Responses

Response samples

Content type
application/json
{}

View seller's deliveries

Endpoint that allows viewing the information of all deliveries of your Seller/Company/Seller. Includes additional filters to narrow down the list

path Parameters
id_seller_
required
integer <int64>

Company/Seller ID, generated by Enviame

delivery_status_id
integer <int64>

Optional field - Enviame status ID

date_from
date

Optional field - Search range start date, format "YYYY-MM-DD"

date_to
date

Optional field - Search range end date, format "YYYY-MM-DD"

page
integer <int64>

Optional field - Page number to query

limit
int <int64>

Optional field - Number of results per page

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Responses

Response samples

Content type
application/json
{}

Print label and add to manifest

Endpoint that allows generating the label for one or more deliveries in Ready for dispatch status (ID 5), setting them to Ready for dispatch - printed status (ID 26) and assigning them to a manifest.

path Parameters
id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Request Body schema: application/json

Print label and add to manifest

deliveries
Array of strings

Required / Delivery IDs to generate label.

type
string

Required / Label format type (PDF)

labelsPerPage
int

Required / Number of labels per page.

Responses

Request samples

Content type
application/json
{
  • "deliveries": [
    ],
  • "type": "pdf",
  • "labelsPerPage": 1
}

View delivery tracking

Endpoint that allows viewing the status history of a Company/Seller delivery.

path Parameters
delivery_id
required
integer <int64>

Delivery ID, generated by Enviame o referencia

query Parameters
all_matches
boolean

This parameter can be used to search by a reference that is not the delivery ID, and a list of deliveries matching the provided reference will be returned.

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

List manifests

Endpoint that allows listing the manifests of a Company/Seller.

path Parameters
id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

query Parameters
status_code[]
Array of strings
Items Enum: "OPEN" "CLOSED" "CONFIRMED"

Optional field / Filters by one or more manifest status codes. Available values according to the manifest service.

with[]
Array of strings
Items Value: "deliveries"

Optional field / Allows including additional relationships in the response.

created_at_from
string <date-time>

Optional field / Manifest creation start date.

created_at_to
string <date-time>

Optional field / Manifest creation end date.

updated_at_to
string <date-time>

Optional field / Manifest update end date.

group_code
string

Optional field / Manifest grouping code.

carrier_code
string

Optional field / Carrier code.

organization_id
integer

Optional field / Associated organization ID.

pudo_id
integer

Optional field / Associated PUDO point ID.

creator_email
string <email>

Optional field / Manifest creator user email.

summary_origin
string

Optional field / Manifest creation origin.

sort_by
string
Example: sort_by=[{"field":"updated_at","order":"desc"}]

Optional field / Sorting criteria in JSON format.

without_deliveries_in_movement
boolean

Optional field / Excludes manifests with deliveries in transit.

delivery_ids[]
Array of integers

Optional field / Delivery IDs to filter manifests.

page
integer >= 1

Optional field / Page number.

limit
integer >= 1

Optional field / Number of records per page.

timezone
string
Default: "etc/utc"

Optional field / Timezone for formatting dates.

services[]
Array of strings

Optional field / Carrier services to filter manifests.

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Responses

Response samples

Content type
application/json
{}

View manifest

Endpoint that allows querying a manifest of a Company/Seller.

path Parameters
id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame.

summary_id
required
integer <int64>

Manifest ID, generated by Enviame.

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Responses

Response samples

Content type
application/json
{}

Generate a manifest

Endpoint that allows generating a manifest for a Company/Seller, with deliveries from the same carrier and source warehouse.

path Parameters
id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Request Body schema: application/json

Create a manifest

deliveries
Array of strings

Required / Delivery IDs to generate the manifest.

custom
boolean

Optional / Indicates whether the manifest should be generated based on Marketcenter

Responses

Request samples

Content type
application/json
{
  • "deliveries": [
    ],
  • "custom": true
}

Close manifest

Endpoint that allows closing a manifest, preventing more deliveries from being added to it.

path Parameters
id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

id_manifiesto
required
integer <int64>

Manifest ID, generado by Enviame

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Request Body schema: application/json
close_type
string or null
Enum: "CLOSE_ANYWAY" "CLOSE_ONE" "CLOSE_BOTH"

Optional / Manifest close type:

  • CLOSE_ANYWAY: closes the manifest including deliveries in transit.
  • CLOSE_ONE: splits deliveries into two manifests; the original manifest keeps only deliveries in transit and is closed, while a new open manifest is created with non-moving deliveries.
  • CLOSE_BOTH: applies the same split as CLOSE_ONE, but also closes the new manifest created with non-moving deliveries.
async
boolean
Default: false

Optional / Defines whether file generation is processed asynchronously.

  • false: waits for the label strip and PDF manifest to be generated before responding.
  • true: generates files in the background and the labels_url and summary_url property URLs will be returned as null.

It is recommended to use this parameter as true if the manifest has a considerable number of deliveries or if you don't need any of the files immediately, as this way the endpoint will respond faster.

Responses

Request samples

Content type
application/json
{
  • "close_type": "CLOSE_ANYWAY",
  • "async": false
}

Response samples

Content type
application/json
{}

Delete delivery

Endpoint that allows deleting deliveries by assigning them the Deleted status (ID 12)

path Parameters
id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

delivery_id
required
integer <int64>

Delivery ID, generated by Enviame

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Responses

Response samples

Content type
application/json
{
  • "data": "El envío se ha eliminado correctamente"
}

Update status of an internal transport delivery

Endpoint to update the status of deliveries belonging to the Internal Transport operator

path Parameters
delivery_id
required
integer <int64>

Delivery ID, generated by Enviame

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Request Body schema: application/json

Change delivery status

code
string

Required / Status ID to apply to the delivery

comment
string

Optional / Comment to be added to the status update record.

changed_at
string

Optional / Date that will be recorded as the status update date

Responses

Request samples

Content type
application/json
{
  • "code": 7,
  • "comment": "Status change made for testing",
  • "changed_at": "2025-03-18 10:00:00"
}

Response samples

Content type
application/json
{}

Company/Seller

Create Company/Seller Warehouse

Endpoint that allows creating warehouses for a Company/Seller. At least one warehouse must be created in order to generate deliveries."

path Parameters
id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Content-Type
required
string
Default: application/json

Not modified

Request Body schema: application/json
name
string

Required / Warehouse name

code
string

Required / Alphanumeric code of the warehouse

place
string

Required / Commune (CL) - City/Municipality (CO) - District (PE) - Neighborhood (MX) - Municipality (AR) where the warehouse is located

full_address
string

Required / Full address of the warehouse, excluding commune

information
string

Additional information or address complement

contact_name
string

Warehouse contact name

contact_phone
string

Contact phone number

contact_email
string

Contact email

Responses

Request samples

Content type
application/json
{
  • "value": {
    }
}

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": {
    },
  • "errors": [ ]
}

View Company/Seller

Endpoint that allows viewing the information of a Company/Seller

path Parameters
id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Responses

Response samples

Content type
application/json
{}

Edit Seller/Company/Seller warehouse

Endpoint that allows editing an existing warehouse assigned to a Company/Seller.

path Parameters
id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

warehouse_code
required
string

Alphanumeric code of the warehouse

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Request Body schema: application/json
name
string

Warehouse name

place
string

Required / Commune (CL) - City/Municipality (CO) - District (PE) - Neighborhood (MX) - Municipality (AR) where the warehouse is located

full_address
string

Warehouse address, excluding commune

Responses

Request samples

Content type
application/json
{
  • "name": "Bodega Prueba Docu",
  • "place": "Cerrillos",
  • "full_address": "Avenida Siempreviva 9870"
}

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": {
    },
  • "errors": [ ]
}

List Company/Seller Employees/Users

Endpoint to list users created as employees of a Company/Seller

path Parameters
id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": [
    ],
  • "meta": {
    }
}

View a Company/Seller warehouse

Endpoint that allows viewing the data of an existing warehouse in a Company/Seller.

path Parameters
id_seller_
required
integer <int64>

Company/Seller ID, generated by Enviame

warehouse_code
required
string

Alphanumeric code of the warehouse

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": {
    },
  • "errors": [ ]
}

List Company/Seller warehouses

Endpoint that allows viewing the complete list of warehouses of a Company/Seller

path Parameters
id_seller_
required
integer <int64>

Company/Seller ID, generated by Enviame

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": [
    ],
  • "meta": {
    },
  • "errors": [ ]
}

List of active carriers in Company/Seller

Endpoint that allows listing the carriers assigned to a Company/Seller.

path Parameters
id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Content-Type
required
string
Default: application/json

Not modified

Responses

Response samples

Content type
application/json
{
  • "status": "success"
}

Delete a seller warehouse

Endpoint that allows deleting warehouses from a Company/Seller

path Parameters
id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

warehouse_id
required
integer <int64>

Warehouse ID, generated by Enviame

header Parameters
api-key
required
string

Company/Seller Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Content-Type
required
string
Default: application/json

Not modified

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": {
    },
  • "errors": [ ]
}

Pickups

Create pickup as a Marketplace seller

Endpoint to schedule pickups using a Marketplace api-key.
The response depends on each carrier's cutoff schedule.

path Parameters
marketplace_id
required
integer <int64>

Marketplace ID, generated by Enviame

id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

header Parameters
api-key
required
string

Marketplace Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Request Body schema: multipart/form-data
carrier_code
string

Required / Carrier code to request the pickup from.

warehouse_code
string

Required / Warehouse code where products will be picked up.

qty
int <int64>

Required / Total number of packages to pick up.

contact_name
string

Required / Name of the pickup contact person (employee).

contact_phone
string

Required / Phone number of the pickup contact person (employee).

range_time
integer

Required (AM or PM) / Can be AM for pickup before 12 PM or PM for after 12 PM.

pickup_date
integer <date>

Optional / Pickup date in YYYY-MM-DD format / If empty, it is scheduled for the next day.

weight
integer

Required / Approximate total weight (Kg.) of the packages.

size
string

Required / "xs, s, m, l, c" / Total size of the packages

custom_size
string

Optional / Only applies for size = C / Pallet or full load dimensions.

Responses

Request samples

Content type
multipart/form-data
{
  "value": {
    "carrier_code": "BLX",
    "warehouse_code": "bod_ruka1",
    "qty": 4,
    "contact_name": "Usuario Bodega",
    "contact_phone": 123456789,
    "range_time": "AM",
    "pickup_date": "21-03-2025",
    "weight": 5,
    "size": "s",
    "custom_size": null
  }
}

Response samples

Content type
application/json
{
  • "code": 201,
  • "data": {
    }
}

Create pickup as Company/Seller

Endpoint to schedule pickups using a Company/Seller api-key. The response depends on each carrier's cutoff schedule.

header Parameters
api-key
required
string

Marketplace Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Request Body schema: multipart/form-data
carrier_code
string

Required / Carrier code to request the pickup from.

warehouse_code
string

Required / Warehouse code where products will be picked up.

qty
int <int64>

Required / Total number of packages to pick up.

contact_name
string

Required / Name of the pickup contact person (employee).

contact_phone
string

Required / Phone number of the pickup contact person (employee).

range_time
integer

Required (AM or PM) / Can be AM for pickup before 12 PM or PM for after 12 PM.

pickup_date
integer <date>

Optional / Pickup date in YYYY-MM-DD format / If empty, it is scheduled for the next day.

weight
integer

Required / Approximate total weight (Kg.) of the packages.

size
string

Required / "xs, s, m, l, c" / Total size of the packages

custom_size
string

Optional / Only applies for size = C / Pallet or full load dimensions.

Responses

Request samples

Content type
multipart/form-data
{
  "value": {
    "carrier_code": "BLX",
    "warehouse_code": "bod_ruka1",
    "qty": 4,
    "contact_name": "Usuario Bodega",
    "contact_phone": 123456789,
    "range_time": "AM",
    "pickup_date": "21-03-2025",
    "weight": 5,
    "size": "s",
    "custom_size": null
  }
}

Response samples

Content type
application/json
{
  • "code": 201,
  • "data": {
    }
}

List pickups as Seller

Lists all pickups created by a Company/Seller. Only works in production environment.

path Parameters
id_seller_
required
integer <int64>

Company/Seller ID, generated by Enviame

header Parameters
Accept
required
string
Default: application/json

Not modified

Responses

Response samples

Content type
application/json
{
  • "status": "success"
}

Returns

Create return

path Parameters
id_seller
required
integer

Seller ID

Request Body schema: application/json
required
object or object

Return origin (home or PUDO/agency)

required
object or object

Return destination (home or warehouse)

required
object
required
object
object

Custom additional fields

Responses

Request samples

Content type
application/json
Example
{
  • "origin": {
    },
  • "destination": {
    },
  • "order": {
    },
  • "carrier": {
    }
}

Response samples

Content type
application/json
{
  • "code": "Success",
  • "message": "creation success",
  • "data": {}
}

Get return tracking

path Parameters
imported_id
required
string

Return identifier (imported_id)

Responses

Response samples

Content type
application/json
{
  • "code": "Success",
  • "message": "ok",
  • "data": {
    }
}

Create return from an existing delivery

path Parameters
id_seller
required
integer

Seller ID

delivery_id
required
integer

Original delivery ID

Request Body schema: application/json
object
object

Responses

Request samples

Content type
application/json
{
  • "order": {
    },
  • "carrier": {
    }
}

Response samples

Content type
application/json
{
  • "code": "Success",
  • "message": "creation success",
  • "data": {
    }
}

Marketplace

Create Warehouse in Company/Seller as Marketplace

Endpoint that allows creating warehouses for a Company/Seller using the associated Marketplace's API Key. At least one warehouse must be created in order to generate deliveries.

path Parameters
id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

id_Marketplace
required
integer <int64>

Marketplace ID, generated by Enviame

header Parameters
api-key
required
string

Marketplace Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Request Body schema: multipart/form-data
name
string

Required / Warehouse name

code
string

Required / Alphanumeric code of the warehouse

place
string

Required / Commune (CL) - City/Municipality (CO) - District (PE) - Neighborhood (MX) - Municipality (AR) where the warehouse is located

full_address
string

Required / Full address of the warehouse, excluding commune

information
string

Additional information or address complement

contact_name
string

Warehouse contact name

contact_phone
string

Contact phone number

contact_email
string

Contact email

Responses

Request samples

Content type
multipart/form-data
{
  "value": {
    "name": "Bodega Prueba Docu",
    "code": "bod_prueba_docu",
    "place": "Cerrillos",
    "full_address": "Avenida Siempreviva 987",
    "information": "Bodega B5",
    "contact_name": "Cosme Fulanito",
    "contact_phone": 998769876,
    "contact_email": "bodega-prueba@enviame.io"
  }
}

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": {
    },
  • "errors": [ ]
}

Edit Company/Seller Warehouse from Marketplace

Endpoint that allows modifying warehouse data of a Company/Seller associated with a Marketplace.

path Parameters
id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

marketplace_id
required
integer <int64>

Marketplace ID, generated by Enviame

warehouse_code
required
string

Alphanumeric code of the warehouse

header Parameters
api-key
required
string

Marketplace Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Request Body schema: application/json
name
string

Warehouse name

place
string

Required / Commune (CL) - City/Municipality (CO) - District (PE) - Neighborhood (MX) - Municipality (AR) where the warehouse is located

full_address
string

Warehouse address, excluding commune

Responses

Request samples

Content type
application/json
{
  • "name": "Bodega 2",
  • "place": "Cerrillos",
  • "full_address": "Avenida Siempreviva 24"
}

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": {
    },
  • "errors": [ ]
}

Delete Company/Seller Warehouse from Marketplace

Endpoint that allows deleting one of the warehouses of a Company/Seller associated with a Marketplace.

path Parameters
id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

marketplace_id
required
integer <int64>

Marketplace ID, generated by Enviame

warehouse_id
required
integer <int64>

Warehouse ID, generated by Enviame

header Parameters
api-key
required
string

Marketplace Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": {
    },
  • "errors": [ ]
}

List Sellers

Endpoint that allows listing all Company/Sellers associated with a Marketplace.

path Parameters
marketplace_id
required
integer <int64>

Marketplace ID, generated by Enviame

header Parameters
api-key
required
string

Marketplace Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Responses

Response samples

Content type
application/json
{}

Assign carrier to Company/Seller

Endpoint that allows assigning a carrier to a Company/Seller, from those already assigned to the Marketplace.

path Parameters
id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

marketplace_id
required
integer <int64>

Marketplace ID, generated by Enviame

header Parameters
api-key
required
string

Marketplace Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Request Body schema: application/json

Assign a carrier to a Company/Seller

code
string

Required / Carrier code

Responses

Request samples

Content type
application/json
{
  • "code": "BLX"
}

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": [
    ],
  • "meta": {
    },
  • "errors": [ ]
}

Edit Seller as Marketplace

Endpoint that allows editing data of a Company/Seller belonging to a Marketplace

path Parameters
marketplace_id
required
integer <int64>

Marketplace ID, generated by Enviame

id_seller
required
integer <int64>

Company/Seller ID, generated by Enviame

header Parameters
api-key
required
string

Marketplace Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Request Body schema: multipart/form-data
name
string

Company/Seller name

corporate_name
string

Corporate name / Legal name

code
string

Alphanumeric code of the Company/Seller

dni
string

Company/Seller RUT (DNI)

website
string

Company/Seller website

Responses

Request samples

Content type
multipart/form-data
{
  "value": {
    "name": "Team Akagi",
    "corporate_name": "Akagi Team",
    "code": "akagi",
    "dni": "11.111.111-1",
    "website": "www.akagiteam.cl"
  }
}

Response samples

Content type
application/json
{}

Create Seller as Marketplace

Endpoint that allows creating a Company/Seller in a Marketplace

path Parameters
marketplace_id_
required
integer <int64>

Marketplace ID, generated by Enviame

header Parameters
api-key
required
string

Marketplace Api-Key, generated by Enviame

Accept
required
string
Default: application/json

Not modified

Request Body schema: application/json

Crear seller como marketplace

name
string

Required / Company/Seller name

corporate_name
string

Required / Corporate name / Legal name

code
string

Alphanumeric code to be assigned to the Company/Seller

dni
string

Required / Company/Seller RUT (DNI)

rule
integer

Rule ID to assign, not used

carrier_code
Array of strings

List of couriers to add to the Company/Seller

Responses

Request samples

Content type
application/json
{
  • "name": "Team Mitsui",
  • "corporate_name": "Mitsui Team",
  • "code": "mitsui_team",
  • "dni": 111111111111,
  • "rule": 0,
  • "carrier_code": [
    ]
}

Response samples

Content type
application/json
{}

Rates

Query rates

This endpoint allows querying shipping rates based on various parameters. Supports queries by weight (kilograms - kg) and by distance (kilometers - km).

query Parameters
from_place_code
required
string

Origin code (CL commune code, CO DANE code, PE ubigeo, MX postal code).

to_place_code
required
string

Destination code (CL commune code, CO DANE code, PE ubigeo, MX postal code).

from_place
string

Origin place name, available for Chile, Colombia and Peru.

to_place
string

Destination place name, available for Chile, Colombia and Peru.

from_address
string

Delivery origin address. Only for KM rates (Chile).

to_address
string

Delivery destination address. Only for KM rates (Chile).

weight
required
number

Product weight in kilograms (kg).

length
number

Product length in centimeters (cm).

width
number

Product width in centimeters (cm).

height
number

Product height in centimeters (cm).

volume
number

Product volume in cubic meters (m³), only for Chile.

type
string
Example: type=nextday&type=estandar

Service category.

carrier
string

Filters by a specific carrier code.

service
string

Filters by a specific carrier service code. Requires the carrier parameter.

carriers[]
Array of strings

Filters by a list of carriers. Combined with type. Ejemplo: carriers[]=CARRIER1&carriers[]=CARRIER2.

km_distance
number

Distance in kilometers.

declared_value
number

Declared product value. Required for CO

header Parameters
x-api-key
required
string

Client API key for authentication.

Responses

Request samples

curl -X GET "https://api.enviame.io/api/v1/prices?weight=1&length=1&width=1&height=1&to_address=HERNANDO%20DE%20AGUIRRE%20268%20OF%20202&from_address=Avenida%20Manquehue%20Norte%201337,%20Local%2011&from_place_code=13101&to_place_code=13101" \
-H "x-api-key: YOUR_API_KEY"

Response samples

Content type
application/json
Example
{
  • "status": "success",
  • "data": [
    ],
  • "meta": {
    }
}