Integrate Reverse Shipments

Carriyo differentiates between forward and reverse shipments. A forward shipment originates from the merchant and is delivered to the customer, while a reverse shipment starts at the customer’s address and is returned to the merchant, typically due to a customer return.

Although similar, forward and reverse shipments have distinct characteristics:

  1. Reporting Benefits : Enables merchants to manage, analyze, and report data differently. For example, you can set separate service levels for reverse shipments and monitor their performance independently.
  2. Carrier Operations : Allows carriers to apply different operational processes for managing reverse shipments.
  3. Collection Instructions : Some carriers may require a separate collection instruction for reverse shipments. This is more common for reverse shipments, though it can also apply to forward shipments.

Steps for Integration

  1. Create a Reverse Shipment : When a customer return request is received, create the reverse shipment in Carriyo. Set the customer’s address as the pickup location and the merchant's store or warehouse as the drop-off location. Include the collection schedule to notify the carrier when to collect the shipment.
    API Endpoint : POST https://api.carriyo.com/shipments

    NOTE: Include "entity_type": "REVERSE" in the shipment request to designate it as a reverse shipment.

  2. Request Collection : Depending on the carrier, reverse shipments might require a separate collection request. You can automate this by enabling the "Auto mark ready-to-ship" setting in the carrier account. Alternatively, manually send the collection request via the Dashboard by updating the shipment status to "Ready to Ship," or perform this step via API once the customer collection is confirmed.
    API Endpoint : POST https://api.carriyo.com/shipments/{shipment-id}/ready-to-ship