STT Booking for POS

Halaman ini menjelaskan fungsi API STT Booking POS, yaitu API yang digunakan oleh agen POS Lion Parcel untuk membuat order pengiriman dan menghasilkan nomor resi (STT) secara langsung melalui sistem

Deskripsi

API STT Booking POS digunakan oleh agen POS Lion Parcel resmi untuk melakukan pembuatan shipment order langsung ke sistem Lion Parcel melalui integrasi API.

Melalui API ini, agen POS dapat:

• Menghasilkan STT/Resi secara real-time.

• Melakukan transaksi booking yang langsung tercatat sebagai transaksi POS.

• Menggunakan saldo akun POS Genesis sebagai sumber pembayaran booking.

Setiap booking yang berhasil akan langsung memotong saldo akun POS Genesis. Apabila saldo tidak mencukupi, maka proses booking tidak dapat dilakukan.

API ini hanya diperuntukkan bagi agen POS Lion Parcel dan tidak dapat digunakan oleh client corporate atau seller umum.

Endpoint

POST	https://api-stg-middleware.thelionparcel.com/pos/booking
URL	[BASE_URL]/pos/booking

Header

Name	Value
Content-Type	application/json
Authorization	Basic UE9TIFBBTE1FUkFIIFVUQVJBIFBPUzE5Nw==

Request Body

Field	Data Type	Is Required	Sample Value	Description
stt_no	STRING	NO	98LP1657731805369	STT manual number
stt_no_ref_external	STRING	NO	INV261101DO	Client refence number
stt_tax_number	STRING	NO	09.314.652.0-987.319	Client tax numbers
stt_goods_estimate_price	INT	YES	10000	Client goods estimate price
stt_goods_status	STRING	NO	ecommerce	Client goods status
stt_origin	STRING	YES	KEBON JERUK, JAKARTA BARAT	Origin route
stt_destination	STRING	YES	KEBON JERUK, JAKARTA BARAT	Destination route
stt_sender_name	STRING	YES	Liona	Sender Name
stt_sender_phone	INT	YES	0872849283718	Sender phone
stt_sender_address	STRING	YES	Jalan Kedoya Raya	Sender Address
stt_recipient_name	STRING	YES	Lio Lio	Consignee’s name
stt_recipient_address	STRING	YES	Jl Belimbing 05	Consignee’s address for delivery
stt_recipient_phone	INT	YES	08123123123123	Consignee’s contact number
stt_insurance_type	STRING	YES	free	Insurance type, free or basic
stt_product_type	STRING	YES	REGPACK	Product name
stt_commodity_code	STRING	YES	ABR036	Commodity code
stt_is_cod	BOOLEAN	YES	true	True, if the shipment is COD.
stt_is_dfod	BOOLEAN	YES	false	True, if the shipment is DFOD.
stt_is_woodpacking	BOOLEAN	YES	false	True, if the shipment use wood packing.
stt_pieces	ARRAY OF OBJECT	YES	Raw data	Piece of package detail Max total 15 pcs Max Weight 400 Kg
stt_piece_per_pack	INT	NO	0	Goods name for pack
stt_next_commodity	STRING	NO	Baju supreme XL	Other commodity name on package
stt_cod_amount	INT	YES if shipment is COD NO	10000	COD amount to be payment

[stt_pieces] structure

Field	Data Type	Is Required	Sample Value	Description
stt_piece_length	INT	YES	10	Actual piece length
stt_piece_width	INT	YES	20	Actual piece width
stt_piece_height	INT	YES	30	Actual piece height
stt_piece_gross_weight	INT	YES	1	Actual gross weight

Request Example

{
    "stt": {
         "stt_no": "",                                    // not mandatory
         "stt_no_ref_external": "ref_external",           // not mandatory
         "stt_tax_number": "",                            // not mandatory
         "stt_goods_estimate_price": 10000,               // *
         "stt_goods_status": "",                          // not mandatory
         "stt_origin": "KEBON JERUK, JAKARTA BARAT",      // * https://bit.ly/3D0TZLv
         "stt_destination": "KEBON JERUK, JAKARTA BARAT", // * https://bit.ly/3D0TZLv
         "stt_sender_name": "Liona",                        // *
         "stt_sender_phone": "0872849283718",             // *
         "stt_sender_address": "Jl. Kedoya",                    // *
         "stt_recipient_name": "Lio Lio",                    // *
         "stt_recipient_address": "Jl. Angsana",                // *
         "stt_recipient_phone": "08123123123123",         // *
         "stt_insurance_type": "free",                    // free or basic
         "stt_product_type": "REGPACK",                   // *
         "stt_commodity_code": "ABR036",                     // * https://bit.ly/3D0TZLv
         "stt_is_cod": true,                             // *false or true | cod = cod harga barang     
         "stt_is_dfod": false,                          // *false or true | dfod = cod ongkir
         "stt_is_woodpacking": false,                      // *false or true
         "stt_pieces": [                                  // maximum 15 pcs, maximum total weight 400 KG
             {
                 "stt_piece_length": 10,                  // * cm
                 "stt_piece_width": 20,                   // * cm
                 "stt_piece_height": 30,                  // * cm
                 "stt_piece_gross_weight": 1              // * kilogram
             },
             {
                 "stt_piece_length": 10,                  // * cm
                 "stt_piece_width": 20,                   // * cm
                 "stt_piece_height": 30,                  // * cm
                 "stt_piece_gross_weight": 2              // * kilogram
             },
             {
                 "stt_piece_length": 15,                  // * cm
                 "stt_piece_width": 25,                   // * cm
                 "stt_piece_height": 35,                  // * cm
                 "stt_piece_gross_weight": 1              // * kilogram
             }
         ],
         "stt_piece_per_pack": 0,                         // not mandatory
         "stt_next_commodity": "",                        // not mandatory
         "stt_cod_amount": 10000                 // * if stt_is_cod = true
     }
}

Response

200

{
  "success": true,
  "code": 201,
  "message": {
    "en": "",
    "id": ""
  },
  "data": {
    "stt": [
      {
        "stt_no": "11LP1643967341740",
        "stt_id": 31579,
        "origin": "KEBON JERUK, JAKARTA BARAT",
        "destination": "KEBON JERUK, JAKARTA BARAT",
        "origin_code": "CGK",
        "destination_code": "CGK",
        "ursa_code_destination": "1KDY"
      }
    ]
  }
}

400