Skip to content

Change shipping deadline

POST /v1/change_ship_deadline

Changes the shipping deadline of an existing order. Only applies to orders that haven't shipped yet.

Request

Send username, password and secretkey along with a data object. See Making requests.

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "secretkey": "YOUR_SECRET_KEY",
  "data": {
    "xid": "23542123",
    "order_id": "1001",
    "ship_deadline": "2026-12-30 00:00:00"
  }
}

curl -X POST https://gatewaybeta.marcofinearts.com/v1/change_ship_deadline \
  -H "Content-Type: application/json" \
  -d '{
    "username": "YOUR_USERNAME",
    "password": "YOUR_PASSWORD",
    "secretkey": "YOUR_SECRET_KEY",
    "data": {
      "xid": "23542123",
      "order_id": "1001",
      "ship_deadline": "2026-12-30 00:00:00"
    }
  }'

data fields

Field Required Validation Notes
xid Conditional Your order number. Required if order_id is not passed.
order_id Conditional Marco Fine Arts order ID. Required if xid is not passed.
ship_deadline Yes YYYY-MM-DD HH:MM:SS At least 5 days after the order date.

Response

{
  "res": "success"
}

{
  "res": "error",
  "code": "000",
  "message": "Error message."
}

Error codes

Code Error Description
801 Authentication failed Your account is invalid or does not have API access. Check username, password and secretkey.
802 Missing field One or more required fields are missing.
806 Invalid format Date format must be YYYY-MM-DD HH:MM:SS.
807 Invalid data Date must be at least 5 days after the order date.
808 Invalid format Date format must be YYYY-MM-DD HH:MM:SS.
813 Error Unexpected error. Try again.
817 Missing field ship_deadline is required.
820 Error Order has already shipped; shipping details can't be changed.