Create Order

Developing

POST

/v1/order

To create an order, users can place a single order or multiple orders in one request. However, multi-order creation is limited to a single courier. If more than one courier is required, it is recommended to create separate orders for each courier. The AWB will be generated after the order is submitted and will be sent via the AWB generation webhook.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "sender_name": "TokuKu",
    "sender_addr_id": "15780",
    "sender_address": "Sidoarjo deket hotel",
    "sender_phone": "08888080880",
    "pickup_via": "0",
    "order_type": "0",
    "input_type": 4,
    "items": [
        {
            "order_code": "BOSAPI123456789116",
            "receiver_name": "penerima",
            "receiver_phone": "08888080888",
            "receiver_address": "jl. alamat penerima",
            "receiver_addr_id": "15780",
            "service_code": "00",
            "item_width": "10",
            "item_height": "10",
            "item_length": "10",
            "item_value": "100000",
            "item_weight": "1",
            "item_qty": "1",
            "item_name": "produk 1",
            "item_category": "3",
            "insurance": "1",
            "cod": "109444"
        }
    ],
    "courier_code": "idx",
    "sender_latitude": "-6.206199753605871",
    "sender_longitude": "106.84524792895677"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://demo.boscod.com:4004/v1/order' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sender_name": "TokuKu",
    "sender_addr_id": "15780",
    "sender_address": "Sidoarjo deket hotel",
    "sender_phone": "08888080880",
    "pickup_via": "0",
    "order_type": "0",
    "input_type": 4,
    "items": [
        {
            "order_code": "BOSAPI123456789116",
            "receiver_name": "penerima",
            "receiver_phone": "08888080888",
            "receiver_address": "jl. alamat penerima",
            "receiver_addr_id": "15780",
            "service_code": "00",
            "item_width": "10",
            "item_height": "10",
            "item_length": "10",
            "item_value": "100000",
            "item_weight": "1",
            "item_qty": "1",
            "item_name": "produk 1",
            "item_category": "3",
            "insurance": "1",
            "cod": "109444"
        }
    ],
    "courier_code": "idx",
    "sender_latitude": "-6.206199753605871",
    "sender_longitude": "106.84524792895677"
}'

Responses

🟢201Created

application/json

Body

Example

{
    "success": true,
    "message": "Data berhasil disimpan, No Resi akan segera dibuat",
    "batch_id": "{batch_id}",
    "order_numbers": [
        "1317123029679001"
    ]
}

🟠400Bad Request

🟠403Forbidden

Modified at 2025-07-29 06:36:36

Orders

Cancel Order