Additional Services
Envia supports additional services that you can include with each shipment to enhance protection, collection, and delivery. These services are added during label creation and their availability depends on the carrier and shipment type.
Types of Additional Services
| Service | Description |
|---|---|
| Envia Insurance | Comprehensive protection provided by Envia with coverage against loss, theft, or damage. Includes a simplified claims process managed directly through Envia. |
| Carrier Insurance | Coverage provided directly by the carrier according to their own terms and conditions. Coverage limits and claims process vary by carrier. |
| Cash On Delivery (COD) | Collect payment from the recipient at the time of delivery. Integrated with Ecart Pay for secure and automated payment management. |
| Electronic Signature | Obtain delivery confirmation with the recipient's digital signature as legal proof of delivery. |
| Pickup Point Delivery | Allow the recipient to pick up the package at a designated pickup point instead of home delivery. |
| Delivery Appointment | Schedule a specific delivery time window with the carrier. Commonly used for large or heavy shipments. |
| Hydraulic Ramp | Request a delivery vehicle equipped with a hydraulic ramp for loading and unloading heavy freight. |
| Dedicated Service | Reserve a full truck exclusively for your shipment without sharing space with other shippers. |
Availability by Shipment Type
Not all services are available for every shipment type. The following table shows which services are available for each type:
| Service | Parcel | LTL (Less Than Truckload) | FTL (Full Truckload) |
|---|---|---|---|
| Envia Insurance | Yes | No | No |
| Carrier Insurance | Yes | Yes | Yes |
| Cash On Delivery (COD) | Yes | No | No |
| Electronic Signature | Yes | No | No |
| Pickup Point Delivery | Yes | No | No |
| Delivery Appointment | No | Yes | Yes |
| Hydraulic Ramp | No | Yes | No |
| Dedicated Service | No | No | Yes |
How to add services to a shipment
Add an additionalServices array inside each package (packages[].additionalServices). Each entry has a service identifier and, for some services, a data object with service-specific parameters.
Send the same services in the rate request (POST /ship/rate/) and in the label request (POST /ship/generate/). The label is priced again from the generate request, and only the services in that request are purchased. A service you quoted but did not send in generate is not applied.
{
"origin": { ... },
"destination": { ... },
"packages": [
{
"type": "box",
"content": "Clothing",
"amount": 1,
"declaredValue": 190,
"weight": 2.2,
"weightUnit": "LB",
"lengthUnit": "IN",
"dimensions": { "length": 11, "width": 9, "height": 3 },
"additionalServices": [
{
"service": "envia_insurance",
"data": {
"amount": "190"
}
}
]
}
],
"shipment": {
"type": 1,
"carrier": "fedex",
"service": "int_express"
}
}shipment.additionalServices is also accepted. For parcel shipments, it is applied to the first package and replaces that package's additionalServices, so prefer the per-package form.
Service identifiers and parameters
| Service | Identifier | Required parameter |
|---|---|---|
| Envia Insurance | envia_insurance | amount (value to insure for that package) |
| Cash On Delivery | cash_on_delivery | amount (amount to collect from recipient) |
| Electronic Signature | electronic_signature | None |
Envia Insurance
Not available for LTL.
Envia Insurance provides comprehensive coverage for your shipments managed directly through the Envia platform. When you add Envia Insurance, the coverage applies to loss, theft, and damage during transit.
How to request it
Send the value to insure in packages[].additionalServices[].data.amount, in the currency of the origin country (USD for US origins). Add it to each package you want to insure, in both rate and generate.
Price and limits
- The premium is a percentage of the insured value, with a minimum premium. Both depend on the carrier, the service and your account.
- Each service has a maximum insured value. If
amountis above it, the request fails with error1126"The maximum amount for envia insurance is $X". - The rate response returns the exact premium for each service, so check it there instead of calculating it yourself.
Where it appears in the responses
| Response | Field | What it contains |
|---|---|---|
| Rate | costSummary[].costAdditionalServices[] | One entry with additionalService: "envia_insurance". value is the insured amount; cost is the premium including taxes. |
| Rate | additionalServices | Total of all additional services, including the Envia Insurance premium |
| Rate | insurance | Carrier insurance only (insurance). Envia Insurance is not included in this field. |
| Generate | data[].additionalFiles[] | The Envia Insurance voucher PDF. It is created only when Envia Insurance was purchased, and it is your proof of coverage. |
Envia Insurance vs. carrier insurance
- Envia Insurance (
envia_insurance) is managed by Envia. The premium is not sent to the carrier. - Carrier insurance (
insurance) is declared to the carrier and follows the carrier's own terms. It is only available on some carriers and services.
If you ship with your own carrier account (custom keys), envia_insurance is sent as carrier insurance (insurance).
Claims
To file a claim, contact Envia support with the tracking number. Keep the insurance voucher, the label, the commercial invoice (for international shipments) and proof of the merchandise value.
Cash On Delivery (COD)
Cash On Delivery allows you to collect payment from the recipient when the package is delivered. This is useful for e-commerce operations where customers prefer to pay upon receipt.
Specify the amount to collect in the amount field. The COD commission cost appears in the rate response under cashOnDeliveryCommission, and the declared collection amount under cashOnDeliveryAmount.
COD is integrated with Ecart Pay for automated payment reconciliation. Collected payments are deposited to your registered account according to the payment schedule.
Learn how to set up your Ecart Pay account to receive cash on delivery payments
Tip: Check the rate response to confirm which additional services are available for each carrier and service combination. Service availability varies by carrier, route, and shipment type.
Recommendations
- Additional services may not be available for all carriers or shipping services.
- If an additional service is not included in the quote response, it means that the service is not available for the selected carrier or shipping service.
Related pages
- Additional Charges — Fuel surcharges, peak season fees, and other carrier charges
- Taxes — How taxes are calculated on shipping costs
- Core Workflow — See how to include additional services when creating labels
Updated 25 days ago
