Domestic Order (Forward)

POST 
/auth/api/v1/orders/order-create

What Is a Forward Order?

A forward order is a shipment picked up from the client's warehouse and delivered to the end customer's doorstep. This API allows you to create forward orders by submitting shipment, pickup, and drop-off details.

This endpoint supports both domestic and international shipments — determined by values like customer_country_code in your payload.

This guide focuses on booking a domestic forward order.

⚠️ Important: Use the location name registered with Logistiq in the pickup_info_name and return_info_name fields.

Optional but Recommended Fields

These fields are optional at the schema level but strongly recommended for better delivery success and end-customer experience:

Field	Purpose
customer_email	Enables shipment tracking and delivery update emails.
customer_phone	Enables SMS notifications and courier coordination.
delivery_instructions	Helps ensure successful first-attempt delivery.

💡 Tip: Including these fields helps you follow the “happy path” for full feature support and optimal performance.

Mandatory National Address Fields (Saudi Arabia Regulation)

As per the Saudi National Address regulation, every eCommerce shipment must include the recipient’s complete and accurate national address. Providing these fields ensures legal compliance, frictionless delivery, reduced failed attempts, and faster service-level performance.

Field	Purpose
customer_city (required)	Customer city name
customer_building_number	Identifies the exact building or villa number required for precise delivery location.
customer_street_name	Ensures the address matches the official national address structure and helps courier navigation.
customer_postal_code	Defines the neighborhood or area to correctly route the shipment to the right distribution zone.
customer_zip_code	Provides the official 5-digit postal code required by Saudi regulatory standards.
customer_additional_number	Supports address verification and helps pinpoint the exact delivery point within a building block.
customer_unit_number	Specifies the apartment, office, or unit number to prevent courier/customer friction.
short_address	a code represents the national address in a short form.

Short Address Field

Optional field: Can be included in the order booking API request.

• Format: 8-character alphanumeric string.
• First 4 characters must be letters (A-Z, case-insensitive).
• Last 4 characters must be digits (0-9).
• Special characters are not allowed.
• No spaces allowed anywhere in the value.
• Leading and trailing spaces will be automatically trimmed.

💡 Tip: Ensure the value matches the pattern AAAA9999 for successful validation.

---

🇸🇦 Note: Starting January 2025, carriers in Saudi Arabia are obligated to validate and store the full national address. Providing these fields will significantly reduce delays, misrouted shipments, and failed delivery attempts.

Responses

200

Order created successfully or forwarded to workflow handler

400

Validation error or order processing failure

401

Authentication credentials were not provided