menu

Import Your Shop Orders

play_arrow
pause
play_arrow
stop

This approach allows you to import orders from your system or online store and process shipments from your personal account at sender.lv.

Sender.lv allows you to import orders directly from your online store or ERP system.

Once you have completed your first API integration in My Account → Integrations / API Settings, the My Account → Import Orders section will become available:

When you click Import Orders, Sender.lv sends an authenticated HTTP GET request to the endpoint URL specified in your integration settings. Your endpoint should respond with a JSON array containing the orders to be imported.

Each request includes the following HTTP header: X-Senderise-Api-Code: your_api_code

Your application should validate this header before returning any order data. If the provided API code is invalid or missing, your endpoint should reject the request (for example, by returning HTTP 401 Unauthorized). Once authentication succeeds, your endpoint should return the order data in the JSON format described below.

This method accepts orders with non-strict validation. However, any data format errors will need to be corrected directly in your sender.lv account.

Sender.lv will send a GET request to your endpoint to retrieve orders from your store:
GET https://yourwebsite.com/orders/export/
The following response expected by your endpoint:

{
  • "internal_order": "123456", Your shop internal order reference / ID
  • "created_at": "1781618229", Unix timestamp when the order was created in your system.
  • "carrier_code": "dpd-door-door", Shipping method code returned by the Get Rates / Get Available Carriers endpoint.
  • "shipment_contents": "iPhone 16 Pro MAX 256 GB; Charger; Glass Protector.", Short description of the shipment contents.
  • "shipment_total_value": "999.99", Declared value of the shipment in EUR. Used for customs declarations and insurance where supported.
  • "package_type": "2", Package type identifier. 1 - Envelope/Documents; 2 - Parcel/Box; 3 - Pallet
  • "from": { Sender Address / Return Address. This will override default pickup address specified in integration settings.
    • "firstname": "Mary", Sender first name.
    • "lastname": "Sue", Sender last name.
    • "email": "[email protected]", Sender email address.
    • "phone": "+371293559772", Sender phone number in international format.
    • "country_iso": "LV", Sender country, two-letter ISO country code.
    • "postcode": "LV-1083", Sender Postal code
    • "city": "Riga", Sender city name
    • "address": "Brivibas iela 25", Address line 1, ex. street name and house number, max 35 symbols.
    • "address2": "Office 12", Additional address information, max. 35 symbols.
    • "parcel_locker_code": "23424" Required only when the shipment originates from a parcel locker. Leave empty for door pickup.
    } ,
  • "to": { Destination Address container
    • "firstname": "John", Recipient first name.
    • "lastname": "Smith", Recipient last name.
    • "email": "[email protected]", Recipient email address. Used for shipment notifications.
    • "phone": "+37129111111", Recipient phone number in international format.
    • "country_iso": "LV", Recipient country, two-letter ISO country code.
    • "postcode": "LV-1083", Recipient postal code
    • "city": "Riga", Recipient city name
    • "address": "Brivibas iela 25", Recipient Address line 1, ex. street name and house number, max 35 symbols.
    • "address2": "Office 12", Recipient additional address information, max. 35 symbols.
    • "parcel_locker_code": "23424" Destination parcel locker code. Required only for shipments to parcel locker. Leave empty for door delivery.
    } ,
  • "packages": [ Container to list packages
    • {
      • "quantity": "1", Number of identical packages with the same dimensions and weight.
      • "width": "48", Package width in centimeters (cm).
      • "depth": "25", Depth in centimeters (cm).
      • "height": "30", Package height in centimeters (cm).
      • "weight": "2.32" Weight of a single package in kilograms (kg).
      }
    ] ,
  • "products": [ Container to list all shipment products
    • {
      • "code": "34534645635", Your internal product SKU or identifier.
      • "name": "iPhone 16 Pro MAX 256Gb", Product name or short description.
      • "width": "9", Product width in centimetres (cm) including package.
      • "height": "2", Product height in centimetres (cm) including package.
      • "depth": "14", Product depth in centimetres (cm) including package.
      • "weight": "0.3", Product weight in kilograms (cm) including package.
      • "price": "979.99", Declared value of a single product in EUR. Used for customs documentation.
      • "quantity": "1" Quantity of this product included in the shipment.
      }
    ] ,
  • "services": [ Container to include some extra services from particular carrier
    • "fragile"
    ]
}


If the connection is successful and your endpoint returns a valid JSON response, clicking Import Orders will display the orders retrieved from your online store:

Before creating shipments, you can review and validate each imported order. Once you are satisfied with the information, click Send Order.

Sender.lv performs additional validation to ensure that all required information is present and formatted correctly. If an order contains missing, invalid, or unsupported data, it cannot be processed. In this case, the order will remain in the import list and the validation errors will be displayed. Simply correct the required information and click Send Order again. Once an order passes validation, it is converted into a shipment and moved to the Shipments section, where you can get shipping labels, track the shipment, and manage its delivery.

Please log in and add your sandbox to play this scenario in real-time