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

ServiceDescription
Envia InsuranceComprehensive protection provided by Envia with coverage against loss, theft, or damage. Includes a simplified claims process managed directly through Envia.
Carrier InsuranceCoverage 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 SignatureObtain delivery confirmation with the recipient's digital signature as legal proof of delivery.
Pickup Point DeliveryAllow the recipient to pick up the package at a designated pickup point instead of home delivery.
Delivery AppointmentSchedule a specific delivery time window with the carrier. Commonly used for large or heavy shipments.
Hydraulic RampRequest a delivery vehicle equipped with a hydraulic ramp for loading and unloading heavy freight.
Dedicated ServiceReserve 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:

ServiceParcelLTL (Less Than Truckload)FTL (Full Truckload)
Envia InsuranceYesNoNo
Carrier InsuranceYesYesYes
Cash On Delivery (COD)YesNoNo
Electronic SignatureYesNoNo
Pickup Point DeliveryYesNoNo
Delivery AppointmentNoYesYes
Hydraulic RampNoYesNo
Dedicated ServiceNoNoYes

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

ServiceIdentifierRequired parameter
Envia Insuranceenvia_insuranceamount (value to insure for that package)
Cash On Deliverycash_on_deliveryamount (amount to collect from recipient)
Electronic Signatureelectronic_signatureNone

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 amount is above it, the request fails with error 1126 "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

ResponseFieldWhat it contains
RatecostSummary[].costAdditionalServices[]One entry with additionalService: "envia_insurance". value is the insured amount; cost is the premium including taxes.
RateadditionalServicesTotal of all additional services, including the Envia Insurance premium
RateinsuranceCarrier insurance only (insurance). Envia Insurance is not included in this field.
Generatedata[].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


Did this page help you?