Borzo Business API 1.4

Requests

All requests to Business API must be made via HTTPS. Only GET and POST request methods are supported. POST requests should send all parameters in the body of the request in JSON format and UTF-8 encoding; GET requests should send parameters in the query string.

All requests must include a HTTP header X-DV-Auth-Token.

• X-DV-Auth-Token string Required

  Secret auth token. Must be sent as a HTTP header.

  Your auth token can be found in your Personal cabinet.

  Important! Never put your auth token in any public places!
  If your token is compromised, it will be possible for anybody to place orders in your name.
  Tokens can be changed in your Personal cabinet.

CURL

curl --include --header 'X-DV-Auth-Token: SECRET_AUTH_TOKEN' 'https://robotapitest-id.borzodelivery.com/api/business/1.4' 

HTTP/1.1 200 OK Date: Sat, 20 Apr 2024 12:17:50 GMT Content-Type: application/json; charset=utf-8  {     "is_successful": true } 

PHP

<?php  $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, 'https://robotapitest-id.borzodelivery.com/api/business/1.4'); curl_setopt($curl, CURLOPT_HTTPHEADER, ['X-DV-Auth-Token: SECRET_AUTH_TOKEN']); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);  $result = curl_exec($curl); if ($result === false) {     throw new Exception(curl_error($curl), curl_errno($curl)); }  echo $result; 

{     "is_successful": true } 

Responses

Business API responses are in JSON format and UTF-8 encoding.

Successful responses will have HTTP code 200 (OK). Response JSON will always have is_successful field.

• is_successful boolean

  Whether the request was successful or not.

  Successful responses will have true here.

If there was an error, API response will have HTTP code 400 (Bad Request). The response JSON will have the following fields:

• is_successful boolean

  Whether the request was successful or not.

  In case of any errors it will be false.

• errors list

  List of error codes.

  Request error codes

• parameter_errors object / null

  Error codes for request parameters. If errors field contains error code invalid_parameters, this field will have detailed parameter errors. Structure of this object corresponds to structure of the request.

  Parameter error codes

CURL

curl --include --header 'X-DV-Auth-Token: SECRET_AUTH_TOKEN' --data '{"points":[{"address":"JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310","contact_person":{"phone":"6288800000001"}},{}]}' 'https://robotapitest-id.borzodelivery.com/api/business/1.4/create-order' 

HTTP/1.1 400 Bad Request Date: Sat, 20 Apr 2024 12:17:50 GMT Content-Type: application/json; charset=utf-8  {     "is_successful": false,     "errors": ["invalid_parameters"],     "parameter_errors": {         "matter": ["required"],         "points": [             null,             {                 "address": ["required"],                 "contact_person": {                     "phone": ["required"]                 }             }         ]     } } 

Parameter data types

• boolean

  Boolean value: true or false.

• integer

  Integer number without fractions.

• string

  A JSON string. Example: "active".

• date

  Date according to ISO 8601: YYYY-MM-DD. Example: "2024-04-20".

• timestamp

  Date and time according to ISO 8601: YYYY-MM-DDTHH:MM:SSZ. Example: "2024-04-20T15:17:50+03:00".

  Please use this exact format with semicolon in the timezone. Other ISO 8601 variants are not supported by Business API.

• float

  Floating point number with fractional part.

• list

  A JSON list. Example: [{"address":"JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310"}, {"address":"Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540"}].

• object

  A JSON object. Example: {"address":"JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310"}.

• money

  Money amount (Rp). This is a JSON string to prevent rounding errors. Examples: "190", "-49".

• phone

  A JSON string with phone number. Example: "6288800000001".

• coordinate

  A JSON string with coordinate. Example: "-6.3037234".

• null

  Empty value: null.

Orders & Deliveries

Order is a general entity that contains all delivery points. You can track order statuses in your personal account or through requests.

Delivery is the entity of a specific order point, only one. Deliveries are created automatically when order is created and have more detailed statuses.

Status model

Order statuses

• new

  Newly created order, waiting for verification from our dispatchers.

• available

  Order was verified and is available for couriers.

• active

  A courier was assigned and is working on the order.

• completed

  Order is completed.

• reactivated

  Order was reactivated and is again available for couriers.

• draft

  The order is a draft and will not be delivered as such. You can create an actual order out of the draft in your Personal cabinet.

• canceled

  Order was canceled.

• delayed

  Order execution was delayed by a dispatcher.

Delivery statuses

• invalid

  Invalid draft delivery

• draft

  Draft delivery

• planned

  Planned delivery (No courier assigned)

• active

  Delivery in process (Courier on the way)

• finished

  Delivery finished (Courier delivered the parcel)

• canceled

  Delivery canceled

• delayed

  Delivery delayed

• failed

  Delivery failed (Courier could not find a customer)

• courier_assigned

  Courier assigned, but still not departed

• courier_departed

  Courier departed to the pick-up point

• courier_at_pickup

  Courier at the pick-up point

• parcel_picked_up

  Courier took parcel at the pick-up point

• courier_arrived

  Courier has arrived and is waiting for a customer

• deleted

  Delivery deleted

• return_planned

  Return planned

• return_courier_assigned

  Courier assigned to return delivery

• return_courier_departed

  Courier departed for return delivery

• return_courier_picked_up

  Courier picked up return delivery

• return_finished

  Delivery is returned

• reattempt_planned

  Reattempt planned

• reattempt_courier_assigned

  Courier assigned to reattempt delivery

• reattempt_courier_departed

  Courier departed for reattempt delivery

• reattempt_courier_picked_up

  Courier picked up reattempt delivery

• reattempt_finished

  Reattempt is finished (delivery finished)

Order types

• standard

  Standard delivery. The courier will be at the addresses at your convenience.

• same_day

  Premium delivery. We will quickly appoint a courier and make a delivery exactly within the chosen interval from the list of available intervals.

• hyperlocal

  Hyperlocal delivery. We will quickly appoint a courier and deliver within a limited area from the pickup point of the order.

Vehicle types

• 1 — Car / SUV / pickup (deliveries under 500 kg).

• 2 — Minivan (under 700 kg).

• 3 — Van (under 1000 kg).

• 7 — Car.

• 8 — Motorbike.

Payment methods

• cash — Cash payment.

• non_cash — Payment from balance.

• bank_card — Payment from binded bank card.

Label types

• zpl

  Label in ZPL (Zebra) format.

• pdf

  Label in PDF format.

Notification about order changes

You may enter a Callback URL in your Personal cabinet and we will send notifications about order changes to that URL.

Data will be sent via HTTP method POST in JSON format and UTF-8 encoding.

Request parameters

• X-DV-Signature string

  Signature of the request data. Use it to verify that the request actually came from our servers.

  The signature will be sent as a HTTP header.

  To verify the signature, calculate a HMAC hash using SHA256 and Callback Secret Key, which can be found in your Personal cabinet.

• event_datetime timestamp

  Event date and time.

• event_type string

  Event type: order_created - if order created, order_changed - if order params changed.

• order object

  Order data.

  Order parameters

  • order_id integer

    Full order ID.

  • type string

    Order type.

    Order types

  • matter string

    Delivery contents.

  • order_name string

    Order name (short order ID).

  • vehicle_type_id integer

    Vehicle type.

    Vehicle types

  • created_datetime timestamp

    Order creation date and time.

  • finish_datetime timestamp / null

    Order completion date and time.

  • status string

    Order status.

    Order statuses

  • status_description string

    Order status description.

  • total_weight_kg integer

    Total weight in kilograms.

  • is_client_notification_enabled boolean

    Whether to send SMS notifications to the client.

  • is_contact_person_notification_enabled boolean

    Whether to send SMS notifications to recipients on addresses.

  • loaders_count integer

    Number of necessary loaders to move the delivered goods, including the driver.

  • points list

    List of addresses (points) for the courier to visit.

    Point parameters

    • point_id integer

      Point ID.

    • delivery_id integer / null

      Delivery ID.

    • address string

      Street address.

    • contact_person object

      Contact person on the address.

      Contact person parameters

      • phone phone

        Phone number of the person at the address.

      • name string / null

        Name of the person on the address.

    • client_order_id string / null

      Your eshop's order ID. It will be sent in notifications instead of our delivery order ID.

    • latitude coordinate

      Latitude of the location.

    • longitude coordinate

      Longitude of the location.

    • required_start_datetime timestamp / null

      How early the courier may arrive at the address.

    • required_finish_datetime timestamp / null

      How late the courier may arrive at the address.

    • arrival_start_datetime timestamp / null

      Estimated courier arrival time, upper bound.

    • arrival_finish_datetime timestamp / null

      Estimated courier arrival time, lower bound.

    • courier_visit_datetime timestamp / null

      Actual courier arrival time.

    • taking_amount money

      Backpayment sum to receive from the contact person at the address.

    • buyout_amount money

      Buyout sum the courier pays to the contact person at the address.

    • note string / null

      Additional information for the courier: office or appartment number, company name, whether any documents are required to enter the building.

    • packages list

      List of packages at the point.

      Package parameters

      • order_package_id integer

        Package ID.

      • ware_code string

        Vendor code.

      • description string

        Description.

      • items_count float

        Amount.

      • item_payment_amount string

        Price per item.

      • nomenclature_code string

        Nomenclature code.

    • is_cod_cash_voucher_required boolean

      Whether to issue a cashier's check to the recipient at the address.

    • is_order_payment_here boolean

      Money will be paid to the courier at the address.

    • building_number string / null

      Building number.

    • entrance_number string / null

      Entrance number.

    • intercom_code string / null

      Intercom code.

    • floor_number string / null

      Floor number.

    • apartment_number string / null

      Apartment/office number.

    • invisible_mile_navigation_instructions string / null

      Instruction to courier how to get to recipient at the address.

    • place_photo_url string / null

      Place photo when closing a point at the address.

    • sign_photo_url string / null

      Recipients signature photo when closing a point at the address.

    • checkin_code string / null

      Courier's arrival pin code at the point.

    • checkin object / null

      Checkin information when closing a point at the address.

      Checkin parameters

      • recipient_full_name string / null

        Full name of the recipient who met the courier.

      • recipient_position string / null

        Position of the recipient who met the courier.

    • is_return_point boolean

      Return point (same as first or hub).

    • tracking_url string / null

      Recipient's tracking link.

    • delivery object / null

      Delivery.

      Delivery parameters

      • status string

        Delivery status.

  • payment_amount money

    Order price.

  • delivery_fee_amount money

    Delivery fee.

    Part of order price (payment_amount).

  • weight_fee_amount money

    Large weight fee.

    Part of order price (payment_amount).

  • insurance_amount money

    Insured amount.

  • insurance_fee_amount money

    Insurance fee.

    Part of order price (payment_amount).

  • loading_fee_amount money

    Loading / heavy lifting fee.

    Part of order price (payment_amount).

  • money_transfer_fee_amount money

    Money handling fee: backpayment transfer, buyout operations.

    Part of order price (payment_amount).

  • overnight_fee_amount money

    Extra fee for overnight parts of the courier's route.

    Part of order price (payment_amount).

  • cod_fee_amount money

    Extra fee for issuing a cashier's check.

    Part of order price (payment_amount).

  • return_fee_amount money

    Extra fee for return to first point.

    Part of order price (payment_amount).

  • waiting_fee_amount money

    Extra fee for paid waiting at designated points.

    Part of order price (payment_amount).

  • backpayment_details string / null

    Details of the money transfer for backpayment. A credit card number or other payment system information.

  • backpayment_photo_url string / null

    URL of backpayment photo (receipt or other payment verification).

  • itinerary_document_url string / null

    URL of itinerary document.

  • waybill_document_url string / null

    URL of waybill document.

  • courier object / null

    Courier parameters.

    Courier parameters

    • courier_id integer

      Courier ID.

    • surname string

      Surname of the courier.

    • name string

      Name of the courier.

    • middlename string

      Middlename of the courier.

    • phone phone

      Phone of the courier.

    • photo_url string / null

      URL of the courier's photo.

    • latitude coordinate / null

      Latitude of the location.

      Only for active orders, if the courier is on the way.

    • longitude coordinate / null

      Longitude of the location.

      Only for active orders, if the courier is on the way.

  • is_motobox_required boolean

    Is motobox required.

  • payment_method string

    Payment method.

    Payment methods

  • bank_card_id integer / null

    Bank card ID for bank_card payment method.

  • applied_promo_code string / null

    Applied promo code.

  • is_return_required boolean

    Order has return.

  • promo_code_discount_amount money

    Discount amount by promo code.

    Part of order price (payment_amount).

If your URL responds with any HTTP status other than 200 (OK), our server will treat it as an error. We will then retry to send the request with increasing intervals between attempts for 24 hours until we get HTTP status 200 in response.

If a successful response was not received after 24 hours, we will stop retrying. In this case an email notification will be sent to your address.

Example of a callback handler

PHP

<?php  if (!isset($_SERVER['HTTP_X_DV_SIGNATURE'])) {     echo 'Error: Signature not found';     exit; }  $data = file_get_contents('php://input');  $signature = hash_hmac('sha256', $data, 'CALLBACK_SECRET_KEY'); if ($signature != $_SERVER['HTTP_X_DV_SIGNATURE']) {     echo 'Error: Signature is not valid';     exit; }  echo $data; 

{     "event_datetime": "2024-04-20T15:17:50+03:00",     "event_type": "order_created",     "order": {         "type": "standard",         "order_id": 1250032,         "order_name": "50032",         "vehicle_type_id": 8,         "created_datetime": "2024-04-20T15:17:50+03:00",         "finish_datetime": null,         "status": "available",         "status_description": "available",         "matter": "Documents",         "total_weight_kg": 0,         "is_client_notification_enabled": false,         "is_contact_person_notification_enabled": false,         "loaders_count": 0,         "backpayment_details": null,         "points": [{             "point_id": 202685,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T15:47:50+03:00",             "required_finish_datetime": "2024-04-20T16:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": {                 "recipient_full_name": "Luvie Mevia Azzahra",                 "recipient_position": null             },             "is_return_point": false,             "tracking_url": null,             "delivery": null         }, {             "point_id": 202686,             "delivery_id": null,             "client_order_id": null,             "address": "Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540",             "latitude": "-6.2914558",             "longitude": "106.8322649",             "required_start_datetime": "2024-04-20T16:47:50+03:00",             "required_finish_datetime": "2024-04-20T17:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }],         "payment_amount": "15000.00",         "delivery_fee_amount": "15000.00",         "weight_fee_amount": "0.00",         "insurance_amount": "0.00",         "insurance_fee_amount": "0.00",         "loading_fee_amount": "0.00",         "money_transfer_fee_amount": "0.00",         "overnight_fee_amount": "0.00",         "promo_code_discount_amount": "3000.00",         "backpayment_amount": "0.00",         "cod_fee_amount": "0.00",         "return_fee_amount": "0.00",         "waiting_fee_amount": "0.00",         "backpayment_photo_url": null,         "itinerary_document_url": null,         "waybill_document_url": null,         "courier": null,         "is_motobox_required": false,         "payment_method": "cash",         "bank_card_id": null,         "applied_promo_code": "FIRST_ORDER",         "is_return_required": false     } } 

Notification about delivery changes

You may enter a Callback URL and enable delivery callback in your Personal cabinet and we will send notifications about delivery changes to that URL.

Data will be sent via HTTP method POST in JSON format and UTF-8 encoding.

Request parameters

• X-DV-Signature string

  Signature of the request data. Use it to verify that the request actually came from our servers.

  The signature will be sent as a HTTP header.

  To verify the signature, calculate a HMAC hash using SHA256 and Callback Secret Key, which can be found in your Personal cabinet.

• event_datetime timestamp

  Event date and time.

• event_type string

  Event type: delivery_created - if delivery created, delivery_changed - if delivery params changed.

• delivery object

  Delivery data.

  Delivery parameters

  • delivery_id integer

    Unique delivery ID.

  • delivery_type string

    Delivery type (for now its only plain supported).

  • order_id integer / null

    Full order ID (for draft delivery it always null).

  • client_id integer

    Client ID.

  • client_order_id string / null

    Your eshop's order ID

  • address string

    Street address.

  • latitude coordinate / null

    Delivery point coordinates (latitude).

  • longitude coordinate / null

    Delivery point coordinates (longitude).

  • status string

    Delivery status.

    Delivery statuses

  • status_description string

    Delivery status description.

  • status_datetime timestamp

    Delivery status change date and time.

  • created_datetime timestamp

    Delivery creation date and time.

  • order_name string / null

    Order name (short order ID).

  • order_payment_amount money / null

    Full order price.

  • delivery_price_amount money / null

    Average delivery price (we calculate price only for order).

  • point_id integer / null

    Point ID.

  • contact_person object

    Contact person on the address.

    Contact person parameters

    • phone phone / null

      Phone number of the person at the address.

    • name string / null

      Name of the person on the address.

  • note string / null

    Additional information for the courier: office or appartment number, company name, whether any documents are required to enter the building.

  • building_number string / null

    Building number.

  • apartment_number string / null

    Apartment/office number.

  • entrance_number string / null

    Entrance number.

  • intercom_code string / null

    Intercom code.

  • floor_number string / null

    Floor number.

  • invisible_mile_navigation_instructions string / null

    Instruction to courier how to get to recipient at the address.

  • required_start_datetime timestamp

    How early the courier may arrive at the address.

  • required_finish_datetime timestamp

    How late the courier may arrive at the address.

  • taking_amount money

    Backpayment sum to receive from the contact person at the address.

  • buyout_amount money

    Buyout sum the courier pays to the contact person at the address.

  • is_cod_cash_voucher_required boolean

    Whether to issue a cashier's check to the recipient at the address.

  • is_motobox_required boolean

    Is motobox required (only for draft).

  • is_door_to_door boolean

    Delivery from door to door (only for draft).

  • is_return_to_first_point_required boolean

    Is return to pick-up point required (only for draft).

  • matter string / null

    Delivery contents (only for draft).

  • insurance_amount money

    Insured amount (only for draft).

  • weight_kg integer

    Weight, in kilograms (only for draft).

  • checkin_issue_name string / null

    Checkin issue name.

  • courier object / null

    Courier parameters.

    Courier parameters

    • courier_id integer

      Courier ID.

    • surname string

      Surname of the courier.

    • name string

      Name of the courier.

    • middlename string

      Middlename of the courier.

    • phone phone

      Phone of the courier.

    • photo_url string / null

      URL of the courier's photo.

    • latitude coordinate / null

      Latitude of the location.

      Only for active orders, if the courier is on the way.

    • longitude coordinate / null

      Longitude of the location.

      Only for active orders, if the courier is on the way.

  • packages list

    List of packages at the delivery point.

    Package parameters

    • delivery_package_id integer / null

      response.common.params.delivery.packages.order_package_id

    • ware_code string

      Vendor code.

    • description string / null

      Description.

    • items_count_units string

      Unit of measurement (pieces, kilograms).

    • items_count float

      Amount.

    • item_payment_amount money

      Price per item.

If your URL responds with any HTTP status other than 200 (OK), our server will treat it as an error. We will then retry to send the request with increasing intervals between attempts for 24 hours until we get HTTP status 200 in response.

If a successful response was not received after 24 hours, we will stop retrying. In this case an email notification will be sent to your address.

Example of a callback handler

PHP

<?php  if (!isset($_SERVER['HTTP_X_DV_SIGNATURE'])) {     echo 'Error: Signature not found';     exit; }  $data = file_get_contents('php://input');  $signature = hash_hmac('sha256', $data, 'CALLBACK_SECRET_KEY'); if ($signature != $_SERVER['HTTP_X_DV_SIGNATURE']) {     echo 'Error: Signature is not valid';     exit; }  echo $data; 

{     "event_datetime": "2024-04-20T15:17:50+03:00",     "event_type": "delivery_created",     "delivery": {         "delivery_id": 11712,         "delivery_type": "plain",         "order_id": 1250032,         "client_id": 180198,         "client_order_id": null,         "address": "Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540",         "latitude": null,         "longitude": null,         "status": "active",         "status_description": "active",         "status_datetime": "2024-04-20T15:17:50+03:00",         "created_datetime": "2024-04-20T15:17:50+03:00",         "order_name": "50032",         "order_payment_amount": "15000.00",         "delivery_price_amount": "15000.00",         "point_id": 203902,         "contact_person": {             "name": null,             "phone": "6288800000001"         },         "note": null,         "building_number": null,         "apartment_number": null,         "entrance_number": null,         "intercom_code": null,         "floor_number": null,         "invisible_mile_navigation_instructions": null,         "required_start_datetime": "2024-04-20T15:47:50+03:00",         "required_finish_datetime": "2024-04-20T16:17:50+03:00",         "taking_amount": "0.00",         "buyout_amount": "0.00",         "is_cod_cash_voucher_required": false,         "is_motobox_required": false,         "is_door_to_door": false,         "is_return_to_first_point_required": false,         "matter": null,         "insurance_amount": "0.00",         "weight_kg": 0,         "packages": [],         "checkin_issue_name": null     } } 

Use cases

How to place an order

The creation scheme for the standard order type consists of 2 stages:

1. Delivery cost calculation and displaying the result to the user.
   To do this, use the /calculate-order method with the same data that will be used when creating the order. At this stage, only recipient's contact data could be missed(data within the fields of the contact_person object) and will not affect the calculation result. The shipping cost will be returned in the payment_amount field.
   The resulting errors will be shown in the warnings block, but the price will be returned even if there are critical errors.
2. Placing an order for delivery.
   To create an order, use the /create-order method, specifying the data in all parameters designated as mandatory. Please note that in the list of points it is impossible to pass less than 2 points, since the first point must be the pick-up point.
   At this stage, all errors are critical and prevent the creation of an order. The list of errors is returned in the errors block. After successfully placing an order, it will be displayed in your personal Borzo account.

To create a same_day order please follow the steps below:

1. Getting available intervals.
   Use the /delivery-intervals method to request available delivery intervals. It is necessary to select one of the intervals received in the response and use it in the required_start_datetime and required_finish_datetime parameters at the delivery point in next steps.
2. Delivery cost calculation and displaying the result to the user.
   To do this, use the /calculate-order method, similar to the standard scheme. Same_day order can only have 2 points. It is also necessary to pass the type parameter with the same_day value. Please note that in this case the required_start_datetime and required_finish_datetime parameters at the delivery point are mandatory.
   The shipping cost will be returned in the payment_amount field.
3. Placing an order for delivery.
   Use the /create-order method to create a same_day order and specify the data in all mandatory parameters. Any errors when creating an order are critical and prevent its placement. The list of errors is returned in the errors block.
   After successfully placing an order, you will be able to see it in your personal Borzo account.

How to track order/delivery

There are two options for tracking order/delivery changes. Automatic via callbacks and manual via request.

Automatic method
We have different callbacks for deliveries and orders for more detailed tracking and completeness of information. In case of any changes in these entities, the system automatically sends callbacks with the necessary information to the Callback URL specified in the personal account on the "Integration" tab. The callback token that is used to calculate signatures is also the same for both types of callbacks. However, the format of callbacks on orders and delivery callbacks varies, which is important to consider when receiving information via this method. If it is impossible to deliver a callback to the specified URL (HTTP code 4xx-5xx), then callbacks are re-sent at an increasing interval until a positive response is received (HTTP code 2xx-3xx), or until 24 hours have passed from the first failed attempt.

Manual method
Manual method allows you to get updated information anytime upon request. You can find detailed description about sending status request on orders and on deliveries.

Goods buyout

Rider will pay for goods he receives and then will take cash for them from the customer if during order placement you pass the following parameters:

• buyout_amount. Belongs to the pickup point. This parameter should contain cash that the rider will have to pay for goods during pickup.
• taking_amount. Belongs to delivery points. Cash amount that should be taken from customers should be passed in this parameter.

Please note that sum of all buyout_amount values in the order can never exceed sum of all taking_amount values in the same order. If total taking amount is greater than total buyout amount in the order, backpayment_details should be used as described in Cash remittance section to get back the difference.

Example of order with goods buyout creation:

curl --include --header 'X-DV-Auth-Token: SECRET_AUTH_TOKEN' --data '{"matter":"Documents","points":[{"address":"JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310","buyout_amount":100.00,"contact_person":{"phone":"6288800000001"}},{"address":"Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540","taking_amount":100.00,"contact_person":{"phone":"6288800000001"}}]}' 'https://robotapitest-id.borzodelivery.com/api/business/1.4/create-order'

Cash remittance

To enable cash remittance option the following parameters should be used during order placement:

• backpayment_details. Belongs to the main body. Please put your bank account details in short form here for rider to be able to send collected cash to it.
• taking_amount. Belongs to delivery points. Cash amount that should be taken from customers should be passed in this parameter.

Example of order with cash remittance creation:

curl --include --header 'X-DV-Auth-Token: SECRET_AUTH_TOKEN' --data '{"matter":"Documents","backpayment_details":"Sample bank details 111111111111","points":[{"address":"JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310","contact_person":{"phone":"6288800000001"}},{"address":"Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540","taking_amount":100.00,"contact_person":{"phone":"6288800000001"}}]}' 'https://robotapitest-id.borzodelivery.com/api/business/1.4/create-order'

Cash on delivery (COD) service

To enable COD feature, you should pass the following parameters during order placement:

• is_cod_cash_voucher_required. Belongs to delivery points. Should be set as true to enable the option.
• taking_amount. Belongs to delivery points. Cash amount that should be taken from customers should be passed in this parameter.

Example of order with COD option creation:

curl --include --header 'X-DV-Auth-Token: SECRET_AUTH_TOKEN' --data '{"matter":"Documents","points":[{"address":"JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310","contact_person":{"phone":"6288800000001"}},{"address":"Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540","is_cod_cash_voucher_required":true,"taking_amount":100.00,"contact_person":{"phone":"6288800000001"}}]}' 'https://robotapitest-id.borzodelivery.com/api/business/1.4/create-order'

API methods

Order price calculation

Use this method to calculate order prices and validate parameters before actually placing the order. It is possible to calculate an incomplete order, but such calculations may be imprecise.

In response to an empty request this method will respond with minimal order price.

You can learn more about our prices at the tariffs page.

Request parameters

• type string

  Order type.

  Default value: "standard".

  For orders of type hyperlocal

  Required
  Hyperlocal clients should set parameter value <code>hyperlocal</code>
  

  Order types

• matter string / null

  Delivery contents. Maximum length is 5,000 characters.

  Try to make this description useful for the courier. For example, putting a category from your catalog here is better than only a concrete model number. If the item is fragile or oversized, please mention it here.

  Default value: null.

• vehicle_type_id integer

  Vehicle type.

  For orders of type standard

  Default value: 8 (Motorbike).
  

  For orders of type same_day

  Prohibited
  In <b>same_day</b>orders it is prohibited to set this parameter <b>vehicle_type_id</b>. It will be detected automatically.
  

  Vehicle types

• total_weight_kg integer

  Total weight in kilograms.

  For orders of type standard

  Default value: <code>0</code>.
  

  For orders of type same_day

  Required
  In <b>same_day</b>orders <b>total_weight_kg</b> parameter is required.
  

• insurance_amount money

  Insured amount.

  Default value: "0.00".

• is_client_notification_enabled boolean

  Whether to send SMS notifications to the client.

  Default value: false.

• is_contact_person_notification_enabled boolean

  Whether to send SMS notifications to recipients on addresses.

  Default value: false.

• is_route_optimizer_enabled boolean

  Automatically optimize route (addresses will be arranged in the optimal order).

  Default value: false.

• loaders_count integer

  Number of necessary loaders to move the delivered goods, including the driver. Maximum is 11.

  Default value: 0.

• backpayment_details string / null

  Details of the money transfer for backpayment. A credit card number or other payment system information. Maximum length is 300 characters.

  Default value: null.

• is_motobox_required boolean

  Is motobox required.

  Default value: false.

• payment_method string

  Payment method (if different from default).

  Default value: null.

  Payment methods

• bank_card_id integer

  Bank card ID (required for bank_card payment method).

  Default value: null.

• promo_code string / null

  Promo code.

  Default value: null.

• points list

  List of addresses (points) for the courier to visit.

  For orders of type standard

  Maximum is 99 points. Default value: <code>[]</code>.
  

  For orders of type same_day

  Only <code>2</code> points should be set in <code>same_day</code> order. Moreover, at the first point params <code>required_start_datetime</code> and <code>required_finish_datetime</code> should not be set, and at the second point params <code>required_start_datetime</code> and <code>required_finish_datetime</code> should satisfy period, received from method <a href='#delivery-intervals'>list of delivery intervals</a>
  

  For orders of type hyperlocal

  Exactly <code>2</code> points should be set in <code>hyperlocal</code> order. Params <code>required_start_datetime</code> and <code>required_finish_datetime</code> are not allowed
  

  Point parameters

  • address string / null

    Street address. Maximum length is 350 characters.

    We use Google Maps API to geocode addresses.

    Default value: null.

  • contact_person object

    Contact person on the address.

    Contact person parameters

    • phone phone / null

      Phone number of the person at the address.

      Default value: null.

    • name string / null

      Name of the person on the address. Maximum length is 350 characters.

      Default value: null.

  • client_order_id string / null

    Your eshop's order ID. It will be sent in notifications instead of our delivery order ID. Maximum length is 32 characters.

    Default value: null.

  • latitude coordinate / null

    Latitude of the location.

    Default value: null.

  • longitude coordinate / null

    Longitude of the location.

    Default value: null.

  • required_start_datetime timestamp / null

    How early the courier may arrive at the address.

    Default value: null.

    For orders of type same_day

    Only <code>2</code> points should be set in <code>same_day</code> order. Moreover, at the first point param <code>required_start_datetime</code> should not be set, and at the second point params <code>required_start_datetime</code> should satisfy period, received from method <a href='#delivery-intervals'>list of delivery intervals</a>
    

    For orders of type hyperlocal

    Prohibited
    Params <code>required_start_datetime</code> is not allowed in <code>hyperlocal</code> order
    

  • required_finish_datetime timestamp / null

    How late the courier may arrive at the address.

    Default value: null.

    For orders of type same_day

    Only <code>2</code> spoints hould be set in <code>same_day</code> order. Moreover, at the first point param <code>required_finish_datetime</code> should not be set, and at the second point params <code>required_finish_datetime</code> should satisfy period, received from method <a href='#delivery-intervals'>list of delivery intervals</a>
    

    For orders of type hyperlocal

    Prohibited
    Params <code>required_finish_datetime</code> is not allowed in <code>hyperlocal</code> order
    

  • taking_amount money

    Backpayment sum to receive from the contact person at the address.

    Default value: "0.00".

  • buyout_amount money

    Buyout sum the courier pays to the contact person at the address.

    Default value: "0.00".

  • note string / null

    Additional information for the courier: office or appartment number, company name, whether any documents are required to enter the building.

    Default value: null.

  • is_order_payment_here boolean

    Money will be paid to the courier at the address.

    Default value: false.

  • building_number string / null

    Building number.

    Default value: null.

  • entrance_number string / null

    Entrance number.

    Default value: null.

  • intercom_code string / null

    Intercom code.

    Default value: null.

  • floor_number string / null

    Floor number.

    Default value: null.

  • apartment_number string / null

    Apartment/office number.

    Default value: null.

  • invisible_mile_navigation_instructions string / null

    Instruction to courier how to get to recipient at the address.

    Default value: null.

  • is_cod_cash_voucher_required boolean

    Whether to issue a cashier's check to the recipient at the point. If true, you should fill check amount in taking_amount.

    Default value: false.

  • delivery_id integer / null

    Unique delivery ID (except first point).

    Default value: null.

Response parameters

• is_successful boolean

  Whether the request was successful or not.

• order object

  Calculated order data.

  Order parameters

  • type string

    Order type.

    Order types

  • matter string / null

    Delivery contents.

  • vehicle_type_id integer

    Vehicle type.

    Vehicle types

  • total_weight_kg integer

    Total weight in kilograms.

  • is_client_notification_enabled boolean

    Whether to send SMS notifications to the client.

  • is_contact_person_notification_enabled boolean

    Whether to send SMS notifications to recipients on addresses.

  • loaders_count integer

    Number of necessary loaders to move the delivered goods, including the driver.

  • points list

    List of addresses (points) for the courier to visit.

    Point parameters

    • address string / null

      Street address.

    • contact_person object

      Contact person on the address.

      Contact person parameters

      • phone phone / null

        Phone number of the person at the address.

      • name string / null

        Name of the person on the address.

    • client_order_id string / null

      Your eshop's order ID. It will be sent in notifications instead of our delivery order ID.

    • latitude coordinate / null

      Latitude of the location.

    • longitude coordinate / null

      Longitude of the location.

    • required_start_datetime timestamp / null

      How early the courier may arrive at the address.

    • required_finish_datetime timestamp / null

      How late the courier may arrive at the address.

    • taking_amount money

      Backpayment sum to receive from the contact person at the address.

    • buyout_amount money

      Buyout sum the courier pays to the contact person at the address.

    • note string / null

      Additional information for the courier: office or appartment number, company name, whether any documents are required to enter the building.

    • packages list

      List of packages at the point.

      Package parameters

      • ware_code string

        Vendor code.

      • description string

        Description.

      • items_count float

        Amount.

      • item_payment_amount string

        Price per item.

      • nomenclature_code string

        response.calculate_order.params.points.packages.nomenclature_code

    • is_cod_cash_voucher_required boolean

      Whether to issue a cashier's check to the recipient at the point.

    • is_order_payment_here boolean

      Money will be paid to the courier at the address.

    • building_number string / null

      Building number.

    • entrance_number string / null

      Entrance number.

    • intercom_code string / null

      Intercom code.

    • floor_number string / null

      Floor number.

    • apartment_number string / null

      Apartment/office number.

    • invisible_mile_navigation_instructions string / null

      Instruction to courier how to get to recipient at the address.

    • place_photo_url string / null

      Place photo when closing a point at the address.

    • sign_photo_url string / null

      Recipients signature photo when closing a point at the address.

    • checkin object / null

      Checkin information when closing a point at the address.

      Checkin parameters

      • recipient_full_name string / null

        Full name of the recipient who met the courier.

      • recipient_position string / null

        Position of the recipient who met the courier.

    • tracking_url string / null

      Recipient's tracking link.

    • delivery object / null

      Delivery.

      Delivery parameters

      • status string / null

        Delivery status.

  • payment_amount money

    Order price.

  • delivery_fee_amount money

    Delivery fee.

    Part of order price (payment_amount).

  • weight_fee_amount money

    Large weight fee.

    Part of order price (payment_amount).

  • insurance_amount money

    Insured amount.

  • insurance_fee_amount money

    Insurance fee.

    Part of order price (payment_amount).

  • loading_fee_amount money

    Loading / heavy lifting fee.

    Part of order price (payment_amount).

  • money_transfer_fee_amount money

    Money handling fee: backpayment transfer, buyout operations.

    Part of order price (payment_amount).

  • overnight_fee_amount money

    Extra fee for overnight parts of the courier's route.

    Part of order price (payment_amount).

  • promo_code_discount_amount money

    Discount amount by promo code.

    Part of order price (payment_amount).

  • cod_fee_amount money

    Extra fee for issuing a cashier's check.

    Part of order price (payment_amount).

  • return_fee_amount money

    Extra fee for return to first point.

    Part of order price (payment_amount).

  • waiting_fee_amount money

    Extra fee for paid waiting at designated points.

    Part of order price (payment_amount).

  • backpayment_details string / null

    Details of the money transfer for backpayment. A credit card number or other payment system information.

  • is_motobox_required boolean

    Is motobox required.

  • applied_promo_code string / null

    Applied promo code.

• warnings list

  Warnings. You will receive these warnings as error codes if you try to create an order with the same data you calculated it with. Empty list of warnings means the order data is valid.

  Request error codes

• parameter_warnings object

  Parameter warnings. You will receive these warnings as parameter error codes if you try to create an order with the same data you calculated it with.

  Parameter error codes

Request example

CURL

curl --include --header 'X-DV-Auth-Token: SECRET_AUTH_TOKEN' --data '{"matter":"Documents","points":[{"address":"JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310"},{"address":"Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540"}]}' 'https://robotapitest-id.borzodelivery.com/api/business/1.4/calculate-order' 

HTTP/1.1 200 OK Date: Sat, 20 Apr 2024 12:17:50 GMT Content-Type: application/json; charset=utf-8  {     "is_successful": true,     "order": {         "type": "standard",         "order_id": 1250032,         "order_name": null,         "vehicle_type_id": 8,         "created_datetime": "2024-04-20T15:17:50+03:00",         "finish_datetime": null,         "status": null,         "status_description": null,         "matter": "Documents",         "total_weight_kg": 0,         "is_client_notification_enabled": false,         "is_contact_person_notification_enabled": false,         "loaders_count": 0,         "backpayment_details": null,         "points": [{             "point_id": null,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T15:47:50+03:00",             "required_finish_datetime": "2024-04-20T16:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": "2024-04-20T15:47:50+03:00"             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": null             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": null         }, {             "point_id": null,             "delivery_id": null,             "client_order_id": null,             "address": "Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540",             "latitude": "-6.2914558",             "longitude": "106.8322649",             "required_start_datetime": "2024-04-20T16:47:50+03:00",             "required_finish_datetime": "2024-04-20T17:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": "2024-04-20T16:47:50+03:00"             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": null             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }],         "payment_amount": "15000.00",         "delivery_fee_amount": "15000.00",         "weight_fee_amount": "0.00",         "insurance_amount": "0.00",         "insurance_fee_amount": "0.00",         "loading_fee_amount": "0.00",         "money_transfer_fee_amount": "0.00",         "overnight_fee_amount": "0.00",         "promo_code_discount_amount": "3000.00",         "backpayment_amount": "0.00",         "cod_fee_amount": "0.00",         "return_fee_amount": "0.00",         "waiting_fee_amount": "0.00",         "backpayment_photo_url": null,         "itinerary_document_url": null,         "waybill_document_url": null,         "courier": null,         "is_motobox_required": false,         "payment_method": "cash",         "bank_card_id": null,         "applied_promo_code": "FIRST_ORDER",         "is_return_required": false     },     "warnings": ["invalid_parameters"],     "parameter_warnings": {         "points": [{             "contact_person": {                 "phone": ["required"]             }         }, {             "contact_person": {                 "phone": ["required"]             }         }]     } } 

PHP

<?php  $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, 'https://robotapitest-id.borzodelivery.com/api/business/1.4/calculate-order'); curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST'); curl_setopt($curl, CURLOPT_HTTPHEADER, ['X-DV-Auth-Token: SECRET_AUTH_TOKEN']); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);  $data = [     'matter' => 'Documents',     'points' => [         [             'address' => 'JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310',         ],         [             'address' => 'Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540',         ],     ], ];  $json = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); curl_setopt($curl, CURLOPT_POSTFIELDS, $json);  $result = curl_exec($curl); if ($result === false) {     throw new Exception(curl_error($curl), curl_errno($curl)); }  echo $result; 

{     "is_successful": true,     "order": {         "type": "standard",         "order_id": 1250032,         "order_name": null,         "vehicle_type_id": 8,         "created_datetime": "2024-04-20T15:17:50+03:00",         "finish_datetime": null,         "status": null,         "status_description": null,         "matter": "Documents",         "total_weight_kg": 0,         "is_client_notification_enabled": false,         "is_contact_person_notification_enabled": false,         "loaders_count": 0,         "backpayment_details": null,         "points": [{             "point_id": null,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T15:47:50+03:00",             "required_finish_datetime": "2024-04-20T16:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": "2024-04-20T15:47:50+03:00"             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": null             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": null         }, {             "point_id": null,             "delivery_id": null,             "client_order_id": null,             "address": "Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540",             "latitude": "-6.2914558",             "longitude": "106.8322649",             "required_start_datetime": "2024-04-20T16:47:50+03:00",             "required_finish_datetime": "2024-04-20T17:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": "2024-04-20T16:47:50+03:00"             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": null             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }],         "payment_amount": "15000.00",         "delivery_fee_amount": "15000.00",         "weight_fee_amount": "0.00",         "insurance_amount": "0.00",         "insurance_fee_amount": "0.00",         "loading_fee_amount": "0.00",         "money_transfer_fee_amount": "0.00",         "overnight_fee_amount": "0.00",         "promo_code_discount_amount": "3000.00",         "backpayment_amount": "0.00",         "cod_fee_amount": "0.00",         "return_fee_amount": "0.00",         "waiting_fee_amount": "0.00",         "backpayment_photo_url": null,         "itinerary_document_url": null,         "waybill_document_url": null,         "courier": null,         "is_motobox_required": false,         "payment_method": "cash",         "bank_card_id": null,         "applied_promo_code": "FIRST_ORDER",         "is_return_required": false     },     "warnings": ["invalid_parameters"],     "parameter_warnings": {         "points": [{             "contact_person": {                 "phone": ["required"]             }         }, {             "contact_person": {                 "phone": ["required"]             }         }]     } } 

Placing an order

This API method creates a new delivery order.

Request parameters

• type string

  Order type.

  Default value: "standard".

  For orders of type hyperlocal

  Required
  Hyperlocal clients should set parameter value <code>hyperlocal</code>
  

  Order types

• matter string Required

  Delivery contents. Maximum length is 5,000 characters.

  Try to make this description useful for the courier. For example, putting a category from your catalog here is better than only a concrete model number. If the item is fragile or oversized, please mention it here.

• vehicle_type_id integer

  Vehicle type.

  For orders of type standard

  Default value: 8 (Motorbike).
  

  For orders of type same_day

  Prohibited
  In <b>same_day</b>orders it is prohibited to set this parameter <b>vehicle_type_id</b>. It will be detected automatically.
  

  Vehicle types

• total_weight_kg integer

  Total weight in kilograms.

  For orders of type standard

  Default value: <code>0</code>.
  

  For orders of type same_day

  Required
  In <b>same_day</b>orders <b>total_weight_kg</b> parameter is required. Must be greater than <code>0</code>.
  

• insurance_amount money

  Insured amount.

  Default value: "0.00".

• is_client_notification_enabled boolean

  Whether to send SMS notifications to the client.

  Default value: false.

• is_contact_person_notification_enabled boolean

  Whether to send SMS notifications to recipients on addresses.

  Default value: false.

• is_route_optimizer_enabled boolean

  Automatically optimize route (addresses will be arranged in the optimal order).

  Default value: false.

• loaders_count integer

  Number of necessary loaders to move the delivered goods, including the driver. Maximum is 11.

  Default value: 0.

• backpayment_details string / null

  Details of the money transfer for backpayment. A credit card number or other payment system information. Maximum length is 300 characters.

  Default value: null.

• is_motobox_required boolean

  Is motobox required.

  Default value: false.

• payment_method string

  Payment method (if different from default).

  Default value: null.

  Payment methods

• bank_card_id integer

  Bank card ID (required for bank_card payment method).

  Default value: null.

• promo_code string / null

  Promo code.

  Default value: null.

• is_return_required boolean

  Need to create order with return.

  Default value: false.

• points list Required

  List of addresses (points) for the courier to visit.

  For orders of type standard

  Maximum is 99 points. Default value: <code>[]</code>.
  

  For orders of type same_day

  Only <code>2</code> points should be set in <code>same_day</code> order. Moreover, at the first point params <code>required_start_datetime</code> and <code>required_finish_datetime</code> should not be set, and at the second point params <code>required_start_datetime</code> and <code>required_finish_datetime</code> should satisfy period, received from method <a href='#delivery-intervals'>list of delivery intervals</a>
  

  For orders of type hyperlocal

  Exactly <code>2</code> points should be set in <code>hyperlocal</code> order. Params <code>required_start_datetime</code> and <code>required_finish_datetime</code> are not allowed
  

  Point parameters

  • address string Required

    Street address. Maximum length is 350 characters.

    We use Google Maps API to geocode addresses.

  • contact_person object Required

    Contact person on the address.

    Contact person parameters

    • phone phone Required

      Phone number of the person at the address.

    • name string / null

      Name of the person on the address. Maximum length is 350 characters.

      Default value: null.

  • client_order_id string / null

    Your eshop's order ID. It will be sent in notifications instead of our delivery order ID. Maximum length is 32 characters.

    Default value: null.

  • latitude coordinate / null

    Latitude of the location.

    Default value: null.

  • longitude coordinate / null

    Longitude of the location.

    Default value: null.

  • required_start_datetime timestamp / null

    How early the courier may arrive at the address.

    Default value: null.

    For orders of type same_day

    Only <code>2</code> points should be set in <code>same_day</code> order. Moreover, at the first point param <code>required_start_datetime</code> should not be set, and at the second point params <code>required_start_datetime</code> should satisfy period, received from method <a href='#delivery-intervals'>list of delivery intervals</a>
    

    For orders of type hyperlocal

    Params <code>required_start_datetime</code> is not allowed in <code>hyperlocal</code> order
    

  • required_finish_datetime timestamp / null

    How late the courier may arrive at the address.

    Default value: null.

    For orders of type same_day

    Only <code>2</code> points should be set in <code>same_day</code> order. Moreover, at the first point param <code>required_finish_datetime</code> should not be set, and at the second point params <code>required_finish_datetime</code> should satisfy period, received from method <a href='#delivery-intervals'>list of delivery intervals</a>
    

    For orders of type hyperlocal

    Params <code>required_finish_datetime</code> is not allowed in <code>hyperlocal</code> order
    

  • taking_amount money

    Backpayment sum to receive from the contact person at the address.

    Default value: "0.00".

  • buyout_amount money

    Buyout sum the courier pays to the contact person at the address.

    Default value: "0.00".

  • note string / null

    Additional information for the courier: office or appartment number, company name, whether any documents are required to enter the building.

    Default value: null.

  • is_order_payment_here boolean

    Money will be paid to the courier at the address.

    Default value: false.

  • building_number string / null

    Building number.

    Default value: null.

  • entrance_number string / null

    Entrance number.

    Default value: null.

  • intercom_code string / null

    Intercom code.

    Default value: null.

  • floor_number string / null

    Floor number.

    Default value: null.

  • apartment_number string / null

    Apartment/office number.

    Default value: null.

  • invisible_mile_navigation_instructions string / null

    Instruction to courier how to get to recipient at the address.

    Default value: null.

  • is_cod_cash_voucher_required boolean

    Whether to issue a cashier's check to the recipient at the point. If true, you should fill check amount in taking_amount.

    Default value: false.

  • delivery_id integer / null

    Unique delivery ID (except first point).

    Default value: null.

Response parameters

• is_successful boolean

  Whether the request was successful or not.

• order object

  The created order.

  Order parameters

  • order_id integer

    Full order ID.

  • type string

    Order type.

    Order types

  • matter string

    Delivery contents.

  • order_name string

    Order name (short order ID).

  • vehicle_type_id integer

    Vehicle type.

    Vehicle types

  • created_datetime timestamp

    Order creation date and time.

  • finish_datetime timestamp / null

    Order completion date and time.

  • status string

    Order status.

    Order statuses

  • status_description string

    Order status description.

  • total_weight_kg integer

    Total weight in kilograms.

  • is_client_notification_enabled boolean

    Whether to send SMS notifications to the client.

  • is_contact_person_notification_enabled boolean

    Whether to send SMS notifications to recipients on addresses.

  • loaders_count integer

    Number of necessary loaders to move the delivered goods, including the driver.

  • points list

    List of addresses (points) for the courier to visit.

    Point parameters

    • point_id integer

      Point ID.

    • delivery_id integer / null

      Delivery ID.

    • address string

      Street address.

    • contact_person object

      Contact person on the address.

      Contact person parameters

      • phone phone

        Phone number of the person at the address.

      • name string / null

        Name of the person on the address.

    • client_order_id string / null

      Your eshop's order ID. It will be sent in notifications instead of our delivery order ID.

    • latitude coordinate

      Latitude of the location.

    • longitude coordinate

      Longitude of the location.

    • required_start_datetime timestamp / null

      How early the courier may arrive at the address.

    • required_finish_datetime timestamp / null

      How late the courier may arrive at the address.

    • arrival_start_datetime timestamp / null

      Estimated courier arrival time, upper bound.

    • arrival_finish_datetime timestamp / null

      Estimated courier arrival time, lower bound.

    • courier_visit_datetime timestamp / null

      Actual courier arrival time.

    • taking_amount money

      Backpayment sum to receive from the contact person at the address.

    • buyout_amount money

      Buyout sum the courier pays to the contact person at the address.

    • note string / null

      Additional information for the courier: office or appartment number, company name, whether any documents are required to enter the building.

    • packages list

      List of packages at the point.

      Package parameters

      • order_package_id integer

        Package ID.

      • ware_code string

        Vendor code.

      • description string

        Description.

      • items_count float

        Amount.

      • item_payment_amount string

        Price per item.

      • nomenclature_code string

        Nomenclature code.

    • is_cod_cash_voucher_required boolean

      Whether to issue a cashier's check to the recipient at the address.

    • is_order_payment_here boolean

      Money will be paid to the courier at the address.

    • building_number string / null

      Building number.

    • entrance_number string / null

      Entrance number.

    • intercom_code string / null

      Intercom code.

    • floor_number string / null

      Floor number.

    • apartment_number string / null

      Apartment/office number.

    • invisible_mile_navigation_instructions string / null

      Instruction to courier how to get to recipient at the address.

    • place_photo_url string / null

      Place photo when closing a point at the address.

    • sign_photo_url string / null

      Recipients signature photo when closing a point at the address.

    • checkin_code string / null

      Courier's arrival pin code at the point.

    • checkin object / null

      Checkin information when closing a point at the address.

      Checkin parameters

      • recipient_full_name string / null

        Full name of the recipient who met the courier.

      • recipient_position string / null

        Position of the recipient who met the courier.

    • is_return_point boolean

      Return point (same as first or hub).

    • tracking_url string / null

      Recipient's tracking link.

    • delivery object / null

      Delivery.

      Delivery parameters

      • status string

        Delivery status.

  • payment_amount money

    Order price.

  • delivery_fee_amount money

    Delivery fee.

    Part of order price (payment_amount).

  • weight_fee_amount money

    Large weight fee.

    Part of order price (payment_amount).

  • insurance_amount money

    Insured amount.

  • insurance_fee_amount money

    Insurance fee.

    Part of order price (payment_amount).

  • loading_fee_amount money

    Loading / heavy lifting fee.

    Part of order price (payment_amount).

  • money_transfer_fee_amount money

    Money handling fee: backpayment transfer, buyout operations.

    Part of order price (payment_amount).

  • overnight_fee_amount money

    Extra fee for overnight parts of the courier's route.

    Part of order price (payment_amount).

  • cod_fee_amount money

    Extra fee for issuing a cashier's check.

    Part of order price (payment_amount).

  • return_fee_amount money

    Extra fee for return to first point.

    Part of order price (payment_amount).

  • waiting_fee_amount money

    Extra fee for paid waiting at designated points.

    Part of order price (payment_amount).

  • backpayment_details string / null

    Details of the money transfer for backpayment. A credit card number or other payment system information.

  • backpayment_photo_url string / null

    URL of backpayment photo (receipt or other payment verification).

  • itinerary_document_url string / null

    URL of itinerary document.

  • waybill_document_url string / null

    URL of waybill document.

  • courier object / null

    Courier parameters.

    Courier parameters

    • courier_id integer

      Courier ID.

    • surname string

      Surname of the courier.

    • name string

      Name of the courier.

    • middlename string

      Middlename of the courier.

    • phone phone

      Phone of the courier.

    • photo_url string / null

      URL of the courier's photo.

    • latitude coordinate / null

      Latitude of the location.

      Only for active orders, if the courier is on the way.

    • longitude coordinate / null

      Longitude of the location.

      Only for active orders, if the courier is on the way.

  • is_motobox_required boolean

    Is motobox required.

  • payment_method string

    Payment method.

    Payment methods

  • bank_card_id integer / null

    Bank card ID for bank_card payment method.

  • applied_promo_code string / null

    Applied promo code.

  • is_return_required boolean

    Order has return.

  • promo_code_discount_amount money

    Discount amount by promo code.

    Part of order price (payment_amount).

Request example

Example 1. Create order with default payment method.

CURL

curl --include --header 'X-DV-Auth-Token: SECRET_AUTH_TOKEN' --data '{"matter":"Documents","points":[{"address":"JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310","contact_person":{"phone":"6288800000001"}},{"address":"Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540","contact_person":{"phone":"6288800000001"}}]}' 'https://robotapitest-id.borzodelivery.com/api/business/1.4/create-order' 

HTTP/1.1 200 OK Date: Sat, 20 Apr 2024 12:17:50 GMT Content-Type: application/json; charset=utf-8  {     "is_successful": true,     "order": {         "type": "standard",         "order_id": 1250032,         "order_name": "50032",         "vehicle_type_id": 8,         "created_datetime": "2024-04-20T15:17:50+03:00",         "finish_datetime": null,         "status": "available",         "status_description": "available",         "matter": "Documents",         "total_weight_kg": 0,         "is_client_notification_enabled": false,         "is_contact_person_notification_enabled": false,         "loaders_count": 0,         "backpayment_details": null,         "points": [{             "point_id": 202685,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T15:47:50+03:00",             "required_finish_datetime": "2024-04-20T16:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": null         }, {             "point_id": 202686,             "delivery_id": null,             "client_order_id": null,             "address": "Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540",             "latitude": "-6.2914558",             "longitude": "106.8322649",             "required_start_datetime": "2024-04-20T16:47:50+03:00",             "required_finish_datetime": "2024-04-20T17:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }],         "payment_amount": "15000.00",         "delivery_fee_amount": "15000.00",         "weight_fee_amount": "0.00",         "insurance_amount": "0.00",         "insurance_fee_amount": "0.00",         "loading_fee_amount": "0.00",         "money_transfer_fee_amount": "0.00",         "overnight_fee_amount": "0.00",         "promo_code_discount_amount": "3000.00",         "backpayment_amount": "0.00",         "cod_fee_amount": "0.00",         "return_fee_amount": "0.00",         "waiting_fee_amount": "0.00",         "backpayment_photo_url": null,         "itinerary_document_url": null,         "waybill_document_url": null,         "courier": null,         "is_motobox_required": false,         "payment_method": "cash",         "bank_card_id": null,         "applied_promo_code": "FIRST_ORDER",         "is_return_required": false     } } 

PHP

<?php  $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, 'https://robotapitest-id.borzodelivery.com/api/business/1.4/create-order'); curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST'); curl_setopt($curl, CURLOPT_HTTPHEADER, ['X-DV-Auth-Token: SECRET_AUTH_TOKEN']); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);  $data = [     'matter' => 'Documents',     'points' => [         [             'address' => 'JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310',             'contact_person' => [                 'phone' => '6288800000001',             ],         ],         [             'address' => 'Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540',             'contact_person' => [                 'phone' => '6288800000001',             ],         ],     ], ];  $json = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); curl_setopt($curl, CURLOPT_POSTFIELDS, $json);  $result = curl_exec($curl); if ($result === false) {     throw new Exception(curl_error($curl), curl_errno($curl)); }  echo $result; 

{     "is_successful": true,     "order": {         "type": "standard",         "order_id": 1250032,         "order_name": "50032",         "vehicle_type_id": 8,         "created_datetime": "2024-04-20T15:17:50+03:00",         "finish_datetime": null,         "status": "available",         "status_description": "available",         "matter": "Documents",         "total_weight_kg": 0,         "is_client_notification_enabled": false,         "is_contact_person_notification_enabled": false,         "loaders_count": 0,         "backpayment_details": null,         "points": [{             "point_id": 202685,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T15:47:50+03:00",             "required_finish_datetime": "2024-04-20T16:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": null         }, {             "point_id": 202686,             "delivery_id": null,             "client_order_id": null,             "address": "Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540",             "latitude": "-6.2914558",             "longitude": "106.8322649",             "required_start_datetime": "2024-04-20T16:47:50+03:00",             "required_finish_datetime": "2024-04-20T17:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }],         "payment_amount": "15000.00",         "delivery_fee_amount": "15000.00",         "weight_fee_amount": "0.00",         "insurance_amount": "0.00",         "insurance_fee_amount": "0.00",         "loading_fee_amount": "0.00",         "money_transfer_fee_amount": "0.00",         "overnight_fee_amount": "0.00",         "promo_code_discount_amount": "3000.00",         "backpayment_amount": "0.00",         "cod_fee_amount": "0.00",         "return_fee_amount": "0.00",         "waiting_fee_amount": "0.00",         "backpayment_photo_url": null,         "itinerary_document_url": null,         "waybill_document_url": null,         "courier": null,         "is_motobox_required": false,         "payment_method": "cash",         "bank_card_id": null,         "applied_promo_code": "FIRST_ORDER",         "is_return_required": false     } } 

Example 2. Create order with bank_card payment method.

CURL

curl --include --header 'X-DV-Auth-Token: SECRET_AUTH_TOKEN' --data '{"matter":"Documents","payment_method":"bank_card","bank_card_id":80,"points":[{"address":"JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310","contact_person":{"phone":"6288800000001"}},{"address":"Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540","contact_person":{"phone":"6288800000001"}}]}' 'https://robotapitest-id.borzodelivery.com/api/business/1.4/create-order' 

HTTP/1.1 200 OK Date: Sat, 20 Apr 2024 12:17:50 GMT Content-Type: application/json; charset=utf-8  {     "is_successful": true,     "order": {         "type": "standard",         "order_id": 1250032,         "order_name": "50032",         "vehicle_type_id": 8,         "created_datetime": "2024-04-20T15:17:50+03:00",         "finish_datetime": null,         "status": "available",         "status_description": "available",         "matter": "Documents",         "total_weight_kg": 0,         "is_client_notification_enabled": false,         "is_contact_person_notification_enabled": false,         "loaders_count": 0,         "backpayment_details": null,         "points": [{             "point_id": 202685,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T15:47:50+03:00",             "required_finish_datetime": "2024-04-20T16:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": null         }, {             "point_id": 202686,             "delivery_id": null,             "client_order_id": null,             "address": "Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540",             "latitude": "-6.2914558",             "longitude": "106.8322649",             "required_start_datetime": "2024-04-20T16:47:50+03:00",             "required_finish_datetime": "2024-04-20T17:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }],         "payment_amount": "15000.00",         "delivery_fee_amount": "15000.00",         "weight_fee_amount": "0.00",         "insurance_amount": "0.00",         "insurance_fee_amount": "0.00",         "loading_fee_amount": "0.00",         "money_transfer_fee_amount": "0.00",         "overnight_fee_amount": "0.00",         "promo_code_discount_amount": "3000.00",         "backpayment_amount": "0.00",         "cod_fee_amount": "0.00",         "return_fee_amount": "0.00",         "waiting_fee_amount": "0.00",         "backpayment_photo_url": null,         "itinerary_document_url": null,         "waybill_document_url": null,         "courier": null,         "is_motobox_required": false,         "payment_method": "bank_card",         "bank_card_id": 80,         "applied_promo_code": "FIRST_ORDER",         "is_return_required": false     } } 

PHP

<?php  $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, 'https://robotapitest-id.borzodelivery.com/api/business/1.4/create-order'); curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST'); curl_setopt($curl, CURLOPT_HTTPHEADER, ['X-DV-Auth-Token: SECRET_AUTH_TOKEN']); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);  $data = [     'matter' => 'Documents',     'payment_method' => 'bank_card',     'bank_card_id' => 80,     'points' => [         [             'address' => 'JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310',             'contact_person' => [                 'phone' => '6288800000001',             ],         ],         [             'address' => 'Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540',             'contact_person' => [                 'phone' => '6288800000001',             ],         ],     ], ];  $json = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); curl_setopt($curl, CURLOPT_POSTFIELDS, $json);  $result = curl_exec($curl); if ($result === false) {     throw new Exception(curl_error($curl), curl_errno($curl)); }  echo $result; 

{     "is_successful": true,     "order": {         "type": "standard",         "order_id": 1250032,         "order_name": "50032",         "vehicle_type_id": 8,         "created_datetime": "2024-04-20T15:17:50+03:00",         "finish_datetime": null,         "status": "available",         "status_description": "available",         "matter": "Documents",         "total_weight_kg": 0,         "is_client_notification_enabled": false,         "is_contact_person_notification_enabled": false,         "loaders_count": 0,         "backpayment_details": null,         "points": [{             "point_id": 202685,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T15:47:50+03:00",             "required_finish_datetime": "2024-04-20T16:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": null         }, {             "point_id": 202686,             "delivery_id": null,             "client_order_id": null,             "address": "Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540",             "latitude": "-6.2914558",             "longitude": "106.8322649",             "required_start_datetime": "2024-04-20T16:47:50+03:00",             "required_finish_datetime": "2024-04-20T17:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }],         "payment_amount": "15000.00",         "delivery_fee_amount": "15000.00",         "weight_fee_amount": "0.00",         "insurance_amount": "0.00",         "insurance_fee_amount": "0.00",         "loading_fee_amount": "0.00",         "money_transfer_fee_amount": "0.00",         "overnight_fee_amount": "0.00",         "promo_code_discount_amount": "3000.00",         "backpayment_amount": "0.00",         "cod_fee_amount": "0.00",         "return_fee_amount": "0.00",         "waiting_fee_amount": "0.00",         "backpayment_photo_url": null,         "itinerary_document_url": null,         "waybill_document_url": null,         "courier": null,         "is_motobox_required": false,         "payment_method": "bank_card",         "bank_card_id": 80,         "applied_promo_code": "FIRST_ORDER",         "is_return_required": false     } } 

Example 3. Create order from draft deliveries. First point cannot be delivery.

CURL

curl --include --header 'X-DV-Auth-Token: SECRET_AUTH_TOKEN' --data '{"matter":"Documents","points":[{"address":"JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310","contact_person":{"phone":"6288800000001"}},{"delivery_id":11712,"address":"Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540","contact_person":{"phone":"6288800000001"}}]}' 'https://robotapitest-id.borzodelivery.com/api/business/1.4/create-order' 

HTTP/1.1 200 OK Date: Sat, 20 Apr 2024 12:17:50 GMT Content-Type: application/json; charset=utf-8  {     "is_successful": true,     "order": {         "type": "standard",         "order_id": 1250032,         "order_name": "50032",         "vehicle_type_id": 8,         "created_datetime": "2024-04-20T15:17:50+03:00",         "finish_datetime": null,         "status": "available",         "status_description": "available",         "matter": "Documents",         "total_weight_kg": 0,         "is_client_notification_enabled": false,         "is_contact_person_notification_enabled": false,         "loaders_count": 0,         "backpayment_details": null,         "points": [{             "point_id": 202685,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T15:47:50+03:00",             "required_finish_datetime": "2024-04-20T16:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": null         }, {             "point_id": 202686,             "delivery_id": 11712,             "client_order_id": null,             "address": "Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540",             "latitude": "-6.2914558",             "longitude": "106.8322649",             "required_start_datetime": "2024-04-20T16:47:50+03:00",             "required_finish_datetime": "2024-04-20T17:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }],         "payment_amount": "15000.00",         "delivery_fee_amount": "15000.00",         "weight_fee_amount": "0.00",         "insurance_amount": "0.00",         "insurance_fee_amount": "0.00",         "loading_fee_amount": "0.00",         "money_transfer_fee_amount": "0.00",         "overnight_fee_amount": "0.00",         "promo_code_discount_amount": "3000.00",         "backpayment_amount": "0.00",         "cod_fee_amount": "0.00",         "return_fee_amount": "0.00",         "waiting_fee_amount": "0.00",         "backpayment_photo_url": null,         "itinerary_document_url": null,         "waybill_document_url": null,         "courier": null,         "is_motobox_required": false,         "payment_method": "cash",         "bank_card_id": null,         "applied_promo_code": "FIRST_ORDER",         "is_return_required": false     } } 

PHP

<?php  $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, 'https://robotapitest-id.borzodelivery.com/api/business/1.4/create-order'); curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST'); curl_setopt($curl, CURLOPT_HTTPHEADER, ['X-DV-Auth-Token: SECRET_AUTH_TOKEN']); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);  $data = [     'matter' => 'Documents',     'points' => [         [             'address' => 'JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310',             'contact_person' => [                 'phone' => '6288800000001',             ],         ],         [             'delivery_id' => 11712,             'address' => 'Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540',             'contact_person' => [                 'phone' => '6288800000001',             ],         ],     ], ];  $json = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); curl_setopt($curl, CURLOPT_POSTFIELDS, $json);  $result = curl_exec($curl); if ($result === false) {     throw new Exception(curl_error($curl), curl_errno($curl)); }  echo $result; 

{     "is_successful": true,     "order": {         "type": "standard",         "order_id": 1250032,         "order_name": "50032",         "vehicle_type_id": 8,         "created_datetime": "2024-04-20T15:17:50+03:00",         "finish_datetime": null,         "status": "available",         "status_description": "available",         "matter": "Documents",         "total_weight_kg": 0,         "is_client_notification_enabled": false,         "is_contact_person_notification_enabled": false,         "loaders_count": 0,         "backpayment_details": null,         "points": [{             "point_id": 202685,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T15:47:50+03:00",             "required_finish_datetime": "2024-04-20T16:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": null         }, {             "point_id": 202686,             "delivery_id": 11712,             "client_order_id": null,             "address": "Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540",             "latitude": "-6.2914558",             "longitude": "106.8322649",             "required_start_datetime": "2024-04-20T16:47:50+03:00",             "required_finish_datetime": "2024-04-20T17:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }],         "payment_amount": "15000.00",         "delivery_fee_amount": "15000.00",         "weight_fee_amount": "0.00",         "insurance_amount": "0.00",         "insurance_fee_amount": "0.00",         "loading_fee_amount": "0.00",         "money_transfer_fee_amount": "0.00",         "overnight_fee_amount": "0.00",         "promo_code_discount_amount": "3000.00",         "backpayment_amount": "0.00",         "cod_fee_amount": "0.00",         "return_fee_amount": "0.00",         "waiting_fee_amount": "0.00",         "backpayment_photo_url": null,         "itinerary_document_url": null,         "waybill_document_url": null,         "courier": null,         "is_motobox_required": false,         "payment_method": "cash",         "bank_card_id": null,         "applied_promo_code": "FIRST_ORDER",         "is_return_required": false     } } 

Order editing

This API method can be used to edit an order in statuses: new, available, active or delayed (Order statuses).

Request parameters

• order_id integer Required

  Full order ID.

To edit the order, send any number of extra parameters from order creation.
If modified value is valid, it will be applied to the order.
If a parameter is not sent with the request, its value will not be changed.
If a parameter is sent with null value, corresponding value will be removed from the order.

When editing a point, always send its ID along with changed values, otherwise a new point will be added to the order. Also, any points with IDs not mentioned in the request will be deleted.

When editing a package, always send its ID along with changed values, otherwise a new package will be added to the point. Also, any packages with IDs not mentioned in the request will be deleted.

See order editing examples to avoid pitfalls.

Response parameters

• is_successful boolean

  Whether the request was successful or not.

• order object

  Modified order data.

  Order parameters

  • order_id integer

    Full order ID.

  • type string

    Order type.

    Order types

  • matter string

    Delivery contents.

  • order_name string

    Order name (short order ID).

  • vehicle_type_id integer

    Vehicle type.

    Vehicle types

  • created_datetime timestamp

    Order creation date and time.

  • finish_datetime timestamp / null

    Order completion date and time.

  • status string

    Order status.

    Order statuses

  • status_description string

    Order status description.

  • total_weight_kg integer

    Total weight in kilograms.

  • is_client_notification_enabled boolean

    Whether to send SMS notifications to the client.

  • is_contact_person_notification_enabled boolean

    Whether to send SMS notifications to recipients on addresses.

  • loaders_count integer

    Number of necessary loaders to move the delivered goods, including the driver.

  • points list

    List of addresses (points) for the courier to visit.

    Point parameters

    • point_id integer

      Point ID.

    • delivery_id integer / null

      Delivery ID.

    • address string

      Street address.

    • contact_person object

      Contact person on the address.

      Contact person parameters

      • phone phone

        Phone number of the person at the address.

      • name string / null

        Name of the person on the address.

    • client_order_id string / null

      Your eshop's order ID. It will be sent in notifications instead of our delivery order ID.

    • latitude coordinate

      Latitude of the location.

    • longitude coordinate

      Longitude of the location.

    • required_start_datetime timestamp / null

      How early the courier may arrive at the address.

    • required_finish_datetime timestamp / null

      How late the courier may arrive at the address.

    • arrival_start_datetime timestamp / null

      Estimated courier arrival time, upper bound.

    • arrival_finish_datetime timestamp / null

      Estimated courier arrival time, lower bound.

    • courier_visit_datetime timestamp / null

      Actual courier arrival time.

    • taking_amount money

      Backpayment sum to receive from the contact person at the address.

    • buyout_amount money

      Buyout sum the courier pays to the contact person at the address.

    • note string / null

      Additional information for the courier: office or appartment number, company name, whether any documents are required to enter the building.

    • packages list

      List of packages at the point.

      Package parameters

      • order_package_id integer

        Package ID.

      • ware_code string

        Vendor code.

      • description string

        Description.

      • items_count float

        Amount.

      • item_payment_amount string

        Price per item.

      • nomenclature_code string

        Nomenclature code.

    • is_cod_cash_voucher_required boolean

      Whether to issue a cashier's check to the recipient at the address.

    • is_order_payment_here boolean

      Money will be paid to the courier at the address.

    • building_number string / null

      Building number.

    • entrance_number string / null

      Entrance number.

    • intercom_code string / null

      Intercom code.

    • floor_number string / null

      Floor number.

    • apartment_number string / null

      Apartment/office number.

    • invisible_mile_navigation_instructions string / null

      Instruction to courier how to get to recipient at the address.

    • place_photo_url string / null

      Place photo when closing a point at the address.

    • sign_photo_url string / null

      Recipients signature photo when closing a point at the address.

    • checkin_code string / null

      Courier's arrival pin code at the point.

    • checkin object / null

      Checkin information when closing a point at the address.

      Checkin parameters

      • recipient_full_name string / null

        Full name of the recipient who met the courier.

      • recipient_position string / null

        Position of the recipient who met the courier.

    • is_return_point boolean

      Return point (same as first or hub).

    • tracking_url string / null

      Recipient's tracking link.

    • delivery object / null

      Delivery.

      Delivery parameters

      • status string

        Delivery status.

  • payment_amount money

    Order price.

  • delivery_fee_amount money

    Delivery fee.

    Part of order price (payment_amount).

  • weight_fee_amount money

    Large weight fee.

    Part of order price (payment_amount).

  • insurance_amount money

    Insured amount.

  • insurance_fee_amount money

    Insurance fee.

    Part of order price (payment_amount).

  • loading_fee_amount money

    Loading / heavy lifting fee.

    Part of order price (payment_amount).

  • money_transfer_fee_amount money

    Money handling fee: backpayment transfer, buyout operations.

    Part of order price (payment_amount).

  • overnight_fee_amount money

    Extra fee for overnight parts of the courier's route.

    Part of order price (payment_amount).

  • cod_fee_amount money

    Extra fee for issuing a cashier's check.

    Part of order price (payment_amount).

  • return_fee_amount money

    Extra fee for return to first point.

    Part of order price (payment_amount).

  • waiting_fee_amount money

    Extra fee for paid waiting at designated points.

    Part of order price (payment_amount).

  • backpayment_details string / null

    Details of the money transfer for backpayment. A credit card number or other payment system information.

  • backpayment_photo_url string / null

    URL of backpayment photo (receipt or other payment verification).

  • itinerary_document_url string / null

    URL of itinerary document.

  • waybill_document_url string / null

    URL of waybill document.

  • courier object / null

    Courier parameters.

    Courier parameters

    • courier_id integer

      Courier ID.

    • surname string

      Surname of the courier.

    • name string

      Name of the courier.

    • middlename string

      Middlename of the courier.

    • phone phone

      Phone of the courier.

    • photo_url string / null

      URL of the courier's photo.

    • latitude coordinate / null

      Latitude of the location.

      Only for active orders, if the courier is on the way.

    • longitude coordinate / null

      Longitude of the location.

      Only for active orders, if the courier is on the way.

  • is_motobox_required boolean

    Is motobox required.

  • payment_method string

    Payment method.

    Payment methods

  • bank_card_id integer / null

    Bank card ID for bank_card payment method.

  • applied_promo_code string / null

    Applied promo code.

  • is_return_required boolean

    Order has return.

  • promo_code_discount_amount money

    Discount amount by promo code.

    Part of order price (payment_amount).

Request example

Example 1. Changing delivery details (matter) and removing backpayment details (backpayment_details).

CURL

curl --include --header 'X-DV-Auth-Token: SECRET_AUTH_TOKEN' --data '{"order_id":1250032,"matter":"Flowers","backpayment_details":null}' 'https://robotapitest-id.borzodelivery.com/api/business/1.4/edit-order' 

HTTP/1.1 200 OK Date: Sat, 20 Apr 2024 12:17:50 GMT Content-Type: application/json; charset=utf-8  {     "is_successful": true,     "order": {         "type": "standard",         "order_id": 1250032,         "order_name": "50032",         "vehicle_type_id": 8,         "created_datetime": "2024-04-20T15:17:50+03:00",         "finish_datetime": null,         "status": "available",         "status_description": "available",         "matter": "Flowers",         "total_weight_kg": 0,         "is_client_notification_enabled": false,         "is_contact_person_notification_enabled": false,         "loaders_count": 0,         "backpayment_details": null,         "points": [{             "point_id": 202685,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T15:47:50+03:00",             "required_finish_datetime": "2024-04-20T16:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": null         }, {             "point_id": 202686,             "delivery_id": null,             "client_order_id": null,             "address": "Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540",             "latitude": "-6.2914558",             "longitude": "106.8322649",             "required_start_datetime": "2024-04-20T16:47:50+03:00",             "required_finish_datetime": "2024-04-20T17:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }],         "payment_amount": "15000.00",         "delivery_fee_amount": "15000.00",         "weight_fee_amount": "0.00",         "insurance_amount": "0.00",         "insurance_fee_amount": "0.00",         "loading_fee_amount": "0.00",         "money_transfer_fee_amount": "0.00",         "overnight_fee_amount": "0.00",         "promo_code_discount_amount": "3000.00",         "backpayment_amount": "0.00",         "cod_fee_amount": "0.00",         "return_fee_amount": "0.00",         "waiting_fee_amount": "0.00",         "backpayment_photo_url": null,         "itinerary_document_url": null,         "waybill_document_url": null,         "courier": null,         "is_motobox_required": false,         "payment_method": "cash",         "bank_card_id": null,         "applied_promo_code": "FIRST_ORDER",         "is_return_required": false } 

PHP

<?php  $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, 'https://robotapitest-id.borzodelivery.com/api/business/1.4/edit-order'); curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST'); curl_setopt($curl, CURLOPT_HTTPHEADER, ['X-DV-Auth-Token: SECRET_AUTH_TOKEN']); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);  $data = [     'order_id'            => 1250032,     'matter'              => 'Flowers',     'backpayment_details' => null, ];  $json = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); curl_setopt($curl, CURLOPT_POSTFIELDS, $json);  $result = curl_exec($curl); if ($result === false) {     throw new Exception(curl_error($curl), curl_errno($curl)); }  echo $result; 

{     "is_successful": true,     "order": {         "type": "standard",         "order_id": 1250032,         "order_name": "50032",         "vehicle_type_id": 8,         "created_datetime": "2024-04-20T15:17:50+03:00",         "finish_datetime": null,         "status": "available",         "status_description": "available",         "matter": "Flowers",         "total_weight_kg": 0,         "is_client_notification_enabled": false,         "is_contact_person_notification_enabled": false,         "loaders_count": 0,         "backpayment_details": null,         "points": [{             "point_id": 202685,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T15:47:50+03:00",             "required_finish_datetime": "2024-04-20T16:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": null         }, {             "point_id": 202686,             "delivery_id": null,             "client_order_id": null,             "address": "Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540",             "latitude": "-6.2914558",             "longitude": "106.8322649",             "required_start_datetime": "2024-04-20T16:47:50+03:00",             "required_finish_datetime": "2024-04-20T17:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }],         "payment_amount": "15000.00",         "delivery_fee_amount": "15000.00",         "weight_fee_amount": "0.00",         "insurance_amount": "0.00",         "insurance_fee_amount": "0.00",         "loading_fee_amount": "0.00",         "money_transfer_fee_amount": "0.00",         "overnight_fee_amount": "0.00",         "promo_code_discount_amount": "3000.00",         "backpayment_amount": "0.00",         "cod_fee_amount": "0.00",         "return_fee_amount": "0.00",         "waiting_fee_amount": "0.00",         "backpayment_photo_url": null,         "itinerary_document_url": null,         "waybill_document_url": null,         "courier": null,         "is_motobox_required": false,         "payment_method": "cash",         "bank_card_id": null,         "applied_promo_code": "FIRST_ORDER",         "is_return_required": false } 

Example 2. Modifying times on a point and adding a new point. First point should be kept as it was.

CURL

curl --include --header 'X-DV-Auth-Token: SECRET_AUTH_TOKEN' --data '{"order_id":1250032,"points":[{"point_id":202685},{"point_id":202686,"required_start_datetime":"2024-04-20T16:47:50+03:00","required_finish_datetime":"2024-04-20T17:17:50+03:00"},{"address":"JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310","contact_person":{"phone":"6288800000001"}}]}' 'https://robotapitest-id.borzodelivery.com/api/business/1.4/edit-order' 

HTTP/1.1 200 OK Date: Sat, 20 Apr 2024 12:17:50 GMT Content-Type: application/json; charset=utf-8  {     "is_successful": true,     "order": {         "type": "standard",         "order_id": 1250032,         "order_name": "50032",         "vehicle_type_id": 8,         "created_datetime": "2024-04-20T15:17:50+03:00",         "finish_datetime": null,         "status": "available",         "status_description": "available",         "matter": "Flowers",         "total_weight_kg": 0,         "is_client_notification_enabled": false,         "is_contact_person_notification_enabled": false,         "loaders_count": 0,         "backpayment_details": null,         "points": [{             "point_id": 202685,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T15:47:50+03:00",             "required_finish_datetime": "2024-04-20T16:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": null         }, {             "point_id": 202686,             "delivery_id": null,             "client_order_id": null,             "address": "Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540",             "latitude": "-6.2914558",             "longitude": "106.8322649",             "required_start_datetime": "2024-04-20T16:47:50+03:00",             "required_finish_datetime": "2024-04-20T17:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }, {             "point_id": 202687,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T17:47:50+03:00",             "required_finish_datetime": "2024-04-20T18:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }],         "payment_amount": "15000.00",         "delivery_fee_amount": "15000.00",         "weight_fee_amount": "0.00",         "insurance_amount": "0.00",         "insurance_fee_amount": "0.00",         "loading_fee_amount": "0.00",         "money_transfer_fee_amount": "0.00",         "overnight_fee_amount": "0.00",         "promo_code_discount_amount": "3000.00",         "backpayment_amount": "0.00",         "cod_fee_amount": "0.00",         "return_fee_amount": "0.00",         "waiting_fee_amount": "0.00",         "backpayment_photo_url": null,         "itinerary_document_url": null,         "waybill_document_url": null,         "courier": null,         "is_motobox_required": false,         "payment_method": "cash",         "bank_card_id": null,         "applied_promo_code": "FIRST_ORDER",         "is_return_required": false } 

PHP

<?php  $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, 'https://robotapitest-id.borzodelivery.com/api/business/1.4/edit-order'); curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST'); curl_setopt($curl, CURLOPT_HTTPHEADER, ['X-DV-Auth-Token: SECRET_AUTH_TOKEN']); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);  $data = [     'order_id' => 1250032,     'points'   => [         [             'point_id' => 202685,         ],         [             'point_id'                 => 202686,             'required_start_datetime'  => '2024-04-20T16:47:50+03:00',             'required_finish_datetime' => '2024-04-20T17:17:50+03:00',         ],         [             'address' => 'JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310',             'contact_person' => [                 'phone' => '6288800000001',             ],         ],     ], ];  $json = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); curl_setopt($curl, CURLOPT_POSTFIELDS, $json);  $result = curl_exec($curl); if ($result === false) {     throw new Exception(curl_error($curl), curl_errno($curl)); }  echo $result; 

{     "is_successful": true,     "order": {         "type": "standard",         "order_id": 1250032,         "order_name": "50032",         "vehicle_type_id": 8,         "created_datetime": "2024-04-20T15:17:50+03:00",         "finish_datetime": null,         "status": "available",         "status_description": "available",         "matter": "Flowers",         "total_weight_kg": 0,         "is_client_notification_enabled": false,         "is_contact_person_notification_enabled": false,         "loaders_count": 0,         "backpayment_details": null,         "points": [{             "point_id": 202685,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T15:47:50+03:00",             "required_finish_datetime": "2024-04-20T16:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": null         }, {             "point_id": 202686,             "delivery_id": null,             "client_order_id": null,             "address": "Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540",             "latitude": "-6.2914558",             "longitude": "106.8322649",             "required_start_datetime": "2024-04-20T16:47:50+03:00",             "required_finish_datetime": "2024-04-20T17:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }, {             "point_id": 202687,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T17:47:50+03:00",             "required_finish_datetime": "2024-04-20T18:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }],         "payment_amount": "15000.00",         "delivery_fee_amount": "15000.00",         "weight_fee_amount": "0.00",         "insurance_amount": "0.00",         "insurance_fee_amount": "0.00",         "loading_fee_amount": "0.00",         "money_transfer_fee_amount": "0.00",         "overnight_fee_amount": "0.00",         "promo_code_discount_amount": "3000.00",         "backpayment_amount": "0.00",         "cod_fee_amount": "0.00",         "return_fee_amount": "0.00",         "waiting_fee_amount": "0.00",         "backpayment_photo_url": null,         "itinerary_document_url": null,         "waybill_document_url": null,         "courier": null,         "is_motobox_required": false,         "payment_method": "cash",         "bank_card_id": null,         "applied_promo_code": "FIRST_ORDER",         "is_return_required": false } 

Example 3. Removing third point from the order.

CURL

curl --include --header 'X-DV-Auth-Token: SECRET_AUTH_TOKEN' --data '{"order_id":1250032,"points":[{"point_id":202685},{"point_id":202686}]}' 'https://robotapitest-id.borzodelivery.com/api/business/1.4/edit-order' 

HTTP/1.1 200 OK Date: Sat, 20 Apr 2024 12:17:50 GMT Content-Type: application/json; charset=utf-8  {     "is_successful": true,     "order": {         "type": "standard",         "order_id": 1250032,         "order_name": "50032",         "vehicle_type_id": 8,         "created_datetime": "2024-04-20T15:17:50+03:00",         "finish_datetime": null,         "status": "available",         "status_description": "available",         "matter": "Flowers",         "total_weight_kg": 0,         "is_client_notification_enabled": false,         "is_contact_person_notification_enabled": false,         "loaders_count": 0,         "backpayment_details": null,         "points": [{             "point_id": 202685,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T15:47:50+03:00",             "required_finish_datetime": "2024-04-20T16:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": null         }, {             "point_id": 202686,             "delivery_id": null,             "client_order_id": null,             "address": "Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540",             "latitude": "-6.2914558",             "longitude": "106.8322649",             "required_start_datetime": "2024-04-20T16:47:50+03:00",             "required_finish_datetime": "2024-04-20T17:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }],         "payment_amount": "15000.00",         "delivery_fee_amount": "15000.00",         "weight_fee_amount": "0.00",         "insurance_amount": "0.00",         "insurance_fee_amount": "0.00",         "loading_fee_amount": "0.00",         "money_transfer_fee_amount": "0.00",         "overnight_fee_amount": "0.00",         "promo_code_discount_amount": "3000.00",         "backpayment_amount": "0.00",         "cod_fee_amount": "0.00",         "return_fee_amount": "0.00",         "waiting_fee_amount": "0.00",         "backpayment_photo_url": null,         "itinerary_document_url": null,         "waybill_document_url": null,         "courier": null,         "is_motobox_required": false,         "payment_method": "cash",         "bank_card_id": null,         "applied_promo_code": "FIRST_ORDER",         "is_return_required": false } 

PHP

<?php  $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, 'https://robotapitest-id.borzodelivery.com/api/business/1.4/edit-order'); curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST'); curl_setopt($curl, CURLOPT_HTTPHEADER, ['X-DV-Auth-Token: SECRET_AUTH_TOKEN']); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);  $data = [     'order_id' => 1250032,     'points'   => [         [             'point_id' => 202685,         ],         [             'point_id' => 202686,         ],     ], ];  $json = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); curl_setopt($curl, CURLOPT_POSTFIELDS, $json);  $result = curl_exec($curl); if ($result === false) {     throw new Exception(curl_error($curl), curl_errno($curl)); }  echo $result; 

{     "is_successful": true,     "order": {         "type": "standard",         "order_id": 1250032,         "order_name": "50032",         "vehicle_type_id": 8,         "created_datetime": "2024-04-20T15:17:50+03:00",         "finish_datetime": null,         "status": "available",         "status_description": "available",         "matter": "Flowers",         "total_weight_kg": 0,         "is_client_notification_enabled": false,         "is_contact_person_notification_enabled": false,         "loaders_count": 0,         "backpayment_details": null,         "points": [{             "point_id": 202685,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T15:47:50+03:00",             "required_finish_datetime": "2024-04-20T16:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": null         }, {             "point_id": 202686,             "delivery_id": null,             "client_order_id": null,             "address": "Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540",             "latitude": "-6.2914558",             "longitude": "106.8322649",             "required_start_datetime": "2024-04-20T16:47:50+03:00",             "required_finish_datetime": "2024-04-20T17:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }],         "payment_amount": "15000.00",         "delivery_fee_amount": "15000.00",         "weight_fee_amount": "0.00",         "insurance_amount": "0.00",         "insurance_fee_amount": "0.00",         "loading_fee_amount": "0.00",         "money_transfer_fee_amount": "0.00",         "overnight_fee_amount": "0.00",         "promo_code_discount_amount": "3000.00",         "backpayment_amount": "0.00",         "cod_fee_amount": "0.00",         "return_fee_amount": "0.00",         "waiting_fee_amount": "0.00",         "backpayment_photo_url": null,         "itinerary_document_url": null,         "waybill_document_url": null,         "courier": null,         "is_motobox_required": false,         "payment_method": "cash",         "bank_card_id": null,         "applied_promo_code": "FIRST_ORDER",         "is_return_required": false } 

Example 4. Setting COD payment attributes. Set the voucher requirement and COD payment amount received at the second point, and remove COD payment and voucher requirement for the third point.

CURL

curl --include --header 'X-DV-Auth-Token: SECRET_AUTH_TOKEN' --data '{"order_id":1250032,"points":[{"point_id":202685},{"point_id":202686, "is_cod_cash_voucher_required": true, "taking_amount": 42000.00},{"point_id": 202687, "is_cod_cash_voucher_required": false, "taking_amount": 0.00}]}' 'https://robotapitest-id.borzodelivery.com/api/business/1.4/edit-order' 

PHP

<?php  $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, 'https://robotapitest-id.borzodelivery.com/api/business/1.4/edit-order'); curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST'); curl_setopt($curl, CURLOPT_HTTPHEADER, ['X-DV-Auth-Token: SECRET_AUTH_TOKEN']); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);  $data = [     'order_id' => 1250032,     'points'   => [         [             'point_id' => 202685,         ],         [             'point_id'                     => 202686,             'is_cod_cash_voucher_required' => true,             'taking_amount'                => 42000.00,         ],         [            'point_id'                     => 202687,            'is_cod_cash_voucher_required' => false,            'taking_amount'                => 0.00,         ],     ], ];  $json = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); curl_setopt($curl, CURLOPT_POSTFIELDS, $json);  $result = curl_exec($curl); if ($result === false) {     throw new Exception(curl_error($curl), curl_errno($curl)); }  echo $result; 

{     "is_successful": true,     "order": {         "type": "standard",         "order_id": 1250032,         "order_name": "50032",         "vehicle_type_id": 8,         "created_datetime": "2024-04-20T15:17:50+03:00",         "finish_datetime": null,         "status": "available",         "status_description": "available",         "matter": "Flowers",         "total_weight_kg": 0,         "is_client_notification_enabled": false,         "is_contact_person_notification_enabled": false,         "loaders_count": 0,         "backpayment_details": null,         "points": [{             "point_id": 202685,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T15:47:50+03:00",             "required_finish_datetime": "2024-04-20T16:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": null         }, {             "point_id": 202686,             "delivery_id": null,             "client_order_id": null,             "address": "Jl. Raya Ragunan No.39, RT.1/RW.2, Ps. Minggu, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12540",             "latitude": "-6.2914558",             "longitude": "106.8322649",             "required_start_datetime": "2024-04-20T16:47:50+03:00",             "required_finish_datetime": "2024-04-20T17:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "estimated_arrival_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "42000.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": true,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }, {             "point_id": 202687,             "delivery_id": null,             "client_order_id": null,             "address": "JL. Jawa, Blok J1 No. 31, Komplek Nusaloka, Tangerang, Rw. Mekar Jaya, Serpong, Kota Tangerang Selatan, Banten 15310",             "latitude": "-6.3037234",             "longitude": "106.6886525",             "required_start_datetime": "2024-04-20T17:47:50+03:00",             "required_finish_datetime": "2024-04-20T18:17:50+03:00",             "arrival_start_datetime": null,             "arrival_finish_datetime": null,             "courier_visit_datetime": null,             "contact_person": {                 "name": null,                 "phone": "6288800000001"             },             "taking_amount": "0.00",             "buyout_amount": "0.00",             "note": null,             "packages": [],             "is_cod_cash_voucher_required": false,             "is_order_payment_here": false,             "building_number": null,             "entrance_number": null,             "intercom_code": null,             "floor_number": null,             "apartment_number": null,             "invisible_mile_navigation_instructions": null,             "place_photo_url": null,             "sign_photo_url": null,             "checkin_code": null,             "checkin": null,             "is_return_point": false,             "tracking_url": null,             "delivery": {                 "status": "planned"             }         }],         "payment_amount": "15000.00",         "delivery_fee_amount": "15000.00",         "weight_fee_amount": "0.00",         "insurance_amount": "0.00",         "insurance_fee_amount": "0.00",         "loading_fee_amount": "0.00",         "money_transfer_fee_amount": "0.00",         "overnight_fee_amount": "0.00",         "backpayment_amount": "0.00",         "cod_fee_amount": "3600.00",         "return_fee_amount": "0.00",         "waiting_fee_amount": "0.00",         "backpayment_photo_url": null,         "itinerary_document_url": null,         "waybill_document_url": null,         "courier": null,         "is_motobox_required": false,         "payment_method": "cash",         "bank_card_id": null     } } 

Canceling an order

You may cancel an order in statuses: new, available, active or delayed (Order statuses). If a courier has visited any addresses, the order cannot be canceled.

Request parameters

• order_id integer Required

  Full order ID to cancel.

Response parameters

• is_successful boolean

  Whether the request was successful or not.

• order object

  Canceled order data.

  Order parameters

  • order_id integer

    Full order ID.

  • type string

    Order type.

    Order types

  • matter string

    Delivery contents.

  • order_name string

    Order name (short order ID).

  • vehicle_type_id integer

    Vehicle type.

    Vehicle types

  • created_datetime timestamp

    Order creation date and time.

  • finish_datetime timestamp / null

    Order completion date and time.

  • status string

    Order status.

    Order statuses

  • status_description string

    Order status description.

  • total_weight_kg integer

    Total weight in kilograms.

  • is_client_notification_enabled boolean

    Whether to send SMS notifications to the client.

  • is_contact_person_notification_enabled boolean

    Whether to send SMS notifications to recipients on addresses.

  • loaders_count integer

    Number of necessary loaders to move the delivered goods, including the driver.

  • points list

    List of addresses (points) for the courier to visit.

    Point parameters

    • point_id integer

      Point ID.

    • delivery_id integer / null

      Delivery ID.

    • address string

      Street address.

    • contact_person object

      Contact person on the address.

      Contact person parameters

      • phone phone

        Phone number of the person at the address.

      • name string / null

        Name of the person on the address.

    • client_order_id string / null

      Your eshop's order ID. It will be sent in notifications instead of our delivery order ID.

    • latitude coordinate

      Latitude of the location.

    • longitude coordinate

      Longitude of the location.

    • required_start_datetime timestamp / null

      How early the courier may arrive at the address.

    • required_finish_datetime timestamp / null

      How late the courier may arrive at the address.

    • arrival_start_datetime timestamp / null

      Estimated courier arrival time, upper bound.

    • arrival_finish_datetime timestamp / null

      Estimated courier arrival time, lower bound.

    • courier_visit_datetime timestamp / null

      Actual courier arrival time.

    • taking_amount money

      Backpayment sum to receive from the contact person at the address.

    • buyout_amount money

      Buyout sum the courier pays to the contact person at the address.

    • note string / null

      Additional information for the courier: office or appartment number, company name, whether any documents are required to enter the building.

    • packages list

      List of packages at the point.

      Package parameters

      • order_package_id integer

        Package ID.

      • ware_code string

        Vendor code.

      • description string

        Description.

      • items_count float

        Amount.

      • item_payment_amount string

        Price per item.

      • nomenclature_code string

        Nomenclature code.

    • is_cod_cash_voucher_required boolean

      Whether to issue a cashier's check to the recipient at the address.

    • is_order_payment_here boolean

      Money will be paid to the courier at the address.

    • building_number string / null

      Building number.

    • entrance_number string / null

      Entrance number.

    • intercom_code string / null

      Intercom code.

    • floor_number string / null

      Floor number.

    • apartment_number string / null

      Apartment/office number.

    • invisible_mile_navigation_instructions string / null

      Instruction to courier how to get to recipient at the address.

    • place_photo_url string / null

      Place photo when closing a point at the address.

    • sign_photo_url string / null

      Recipients signature photo when closing a point at the address.

    • checkin_code string / null

      Courier's arrival pin code at the point.

    • checkin object / null

      Checkin information when closing a point at the address.

      Checkin parameters

      • recipient_full_name string / null

        Full name of the recipient who met the courier.

      • recipient_position string / null

        Position of the recipient who met the courier.

    • is_return_point boolean

      Return point (same as first or hub).

    • tracking_url string / null

      Recipient's tracking link.

    • delivery object / null

      Delivery.

      Delivery parameters

      • status string

        Delivery status.

  • payment_amount money

    Order price.

  • delivery_fee_amount money

    Delivery fee.

    Part of order price (payment_amount).

  • weight_fee_amount money

    Large weight fee.

    Part of order price (payment_amount).

  • insurance_amount money

    Insured amount.

  • insurance_fee_amount money

    Insurance fee.

    Part of order price (payment_amount).

  • loading_fee_amount money

    Loading / heavy lifting fee.

    Part of order price (payment_amount).

  • money_transfer_fee_amount money

    Money handling fee: backpayment transfer, buyout operations.

    Part of order price (payment_amount).

  • overnight_fee_amount money

    Extra fee for overnight parts of the courier's route.

    Part of order price (payment_amount).

  • cod_fee_amount money

    Extra fee for issuing a cashier's check.

    Part of order price (payment_amount).

  • return_fee_amount money

    Extra fee for return to first point.

    Part of order price (payment_amount).

  • waiting_fee_amount money

    Extra fee for paid waiting at designated points.

    Part of order price (payment_amount).

  • backpayment_details string / null

    Details of the money transfer for backpayment. A credit card number or other payment system information.

  • backpayment_photo_url string / null

    URL of backpayment photo (receipt or other payment verification).

  • itinerary_document_url string / null

    URL of itinerary document.

  • waybill_document_url string / null

    URL of waybill document.

  • courier object / null

    Courier parameters.

    Courier parameters

    • courier_id integer

      Courier ID.

    • surname string

      Surname of the courier.

    • name string

      Name of the courier.

    • middlename string

      Middlename of the courier.

    • phone phone

      Phone of the courier.

    • photo_url string / null

      URL of the courier's photo.

    • latitude coordinate / null

      Latitude of the location.

      Only for active orders, if the courier is on the way.

    • longitude coordinate / null

      Longitude of the location.

      Only for active orders, if the courier is on the way.

  • is_motobox_required boolean

    Is motobox required.

  • payment_method string

    Payment method.

    Payment methods

  • bank_card_id integer / null

    Bank card ID for bank_card payment method.

  • applied_promo_code string / null

    Applied promo code.

  • is_return_required boolean

    Order has return.

  • promo_code_discount_amount money

    Discount amount by promo code.

    Part of order price (payment_amount).