Upload Order File

curl --request POST \
  --url https://api.platform.poderp.com/api/openapi/order/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form templateId=123 \
  --form file=@example-file \
  --form attachments=@example-file \
  --form namingType=default \
  --form urlSplitToken=0 \
  --form needDownloadImage=true \
  --form newImageDownload=false

import requests

url = "https://api.platform.poderp.com/api/openapi/order/upload"

files = {
    "file": ("example-file", open("example-file", "rb")),
    "attachments": ("example-file", open("example-file", "rb"))
}
payload = {
    "templateId": "123",
    "namingType": "default",
    "urlSplitToken": "0",
    "needDownloadImage": "true",
    "newImageDownload": "false"
}
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('templateId', '123');
form.append('file', '<string>');
form.append('attachments', '<string>');
form.append('namingType', 'default');
form.append('urlSplitToken', '0');
form.append('needDownloadImage', 'true');
form.append('newImageDownload', 'false');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://api.platform.poderp.com/api/openapi/order/upload', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.platform.poderp.com/api/openapi/order/upload",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"templateId\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"attachments\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"namingType\"\r\n\r\ndefault\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"urlSplitToken\"\r\n\r\n0\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"needDownloadImage\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"newImageDownload\"\r\n\r\nfalse\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: multipart/form-data"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.platform.poderp.com/api/openapi/order/upload"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"templateId\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"attachments\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"namingType\"\r\n\r\ndefault\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"urlSplitToken\"\r\n\r\n0\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"needDownloadImage\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"newImageDownload\"\r\n\r\nfalse\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.platform.poderp.com/api/openapi/order/upload")
  .header("Authorization", "Bearer <token>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"templateId\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"attachments\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"namingType\"\r\n\r\ndefault\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"urlSplitToken\"\r\n\r\n0\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"needDownloadImage\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"newImageDownload\"\r\n\r\nfalse\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.platform.poderp.com/api/openapi/order/upload")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"templateId\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"attachments\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"namingType\"\r\n\r\ndefault\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"urlSplitToken\"\r\n\r\n0\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"needDownloadImage\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"newImageDownload\"\r\n\r\nfalse\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "totalRows": 123,
  "errors": [
    {
      "rowIndex": 123,
      "errors": [
        "<string>"
      ]
    }
  ],
  "mainOrderId": "<string>",
  "uniqueRequestId": "<string>"
}

{
  "success": true,
  "totalRows": 123,
  "errors": [
    {
      "rowIndex": 123,
      "errors": [
        "<string>"
      ]
    }
  ],
  "mainOrderId": "<string>",
  "uniqueRequestId": "<string>"
}

POST

api

openapi

order

upload

Upload Order File

curl --request POST \
  --url https://api.platform.poderp.com/api/openapi/order/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form templateId=123 \
  --form file=@example-file \
  --form attachments=@example-file \
  --form namingType=default \
  --form urlSplitToken=0 \
  --form needDownloadImage=true \
  --form newImageDownload=false

import requests

url = "https://api.platform.poderp.com/api/openapi/order/upload"

files = {
    "file": ("example-file", open("example-file", "rb")),
    "attachments": ("example-file", open("example-file", "rb"))
}
payload = {
    "templateId": "123",
    "namingType": "default",
    "urlSplitToken": "0",
    "needDownloadImage": "true",
    "newImageDownload": "false"
}
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('templateId', '123');
form.append('file', '<string>');
form.append('attachments', '<string>');
form.append('namingType', 'default');
form.append('urlSplitToken', '0');
form.append('needDownloadImage', 'true');
form.append('newImageDownload', 'false');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://api.platform.poderp.com/api/openapi/order/upload', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.platform.poderp.com/api/openapi/order/upload",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"templateId\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"attachments\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"namingType\"\r\n\r\ndefault\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"urlSplitToken\"\r\n\r\n0\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"needDownloadImage\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"newImageDownload\"\r\n\r\nfalse\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: multipart/form-data"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.platform.poderp.com/api/openapi/order/upload"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"templateId\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"attachments\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"namingType\"\r\n\r\ndefault\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"urlSplitToken\"\r\n\r\n0\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"needDownloadImage\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"newImageDownload\"\r\n\r\nfalse\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.platform.poderp.com/api/openapi/order/upload")
  .header("Authorization", "Bearer <token>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"templateId\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"attachments\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"namingType\"\r\n\r\ndefault\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"urlSplitToken\"\r\n\r\n0\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"needDownloadImage\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"newImageDownload\"\r\n\r\nfalse\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.platform.poderp.com/api/openapi/order/upload")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"templateId\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"attachments\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"namingType\"\r\n\r\ndefault\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"urlSplitToken\"\r\n\r\n0\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"needDownloadImage\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"newImageDownload\"\r\n\r\nfalse\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "totalRows": 123,
  "errors": [
    {
      "rowIndex": 123,
      "errors": [
        "<string>"
      ]
    }
  ],
  "mainOrderId": "<string>",
  "uniqueRequestId": "<string>"
}

{
  "success": true,
  "totalRows": 123,
  "errors": [
    {
      "rowIndex": 123,
      "errors": [
        "<string>"
      ]
    }
  ],
  "mainOrderId": "<string>",
  "uniqueRequestId": "<string>"
}

Upload an Excel order list with the same parsing template used by operators in the order import screen. This endpoint uses your existing customer API key.

Availability requires the backend release containing this endpoint to be deployed.

Prepare the order file

Call List Order Templates and choose an enabled order template.
Prepare one .xlsx or .xls file whose headers match the template’s columns. The file must contain at least one data row.
Include your customer name in the filename, as in the operator workflow. For customer ZTQ, 26ZTQ018.xlsx is valid.
Send a multipart/form-data request. Let your HTTP client generate the multipart boundary.

The API key determines the order customer. Do not send selectedUser, customerId, action or an operator login token. This endpoint always imports orders and preserves the existing Excel order and factory validation rules.

Example

curl --request POST 'https://api.platform.poderp.com/api/openapi/order/upload' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --form 'templateId=YOUR_TEMPLATE_ID' \
  --form 'file=@26ZTQ018.xlsx' \
  --form 'urlSplitToken=0' \
  --form 'namingType=default' \
  --form 'newImageDownload=true' \
  --form 'needDownloadImage=false'

This example matches the screenshot workflow: import orders, use pipe-separated image URLs, select the new downloader, and disable image downloads. Set needDownloadImage=true to create image download tasks. To include attachments, repeat the field:

--form 'attachments=@notes.pdf' \
--form 'attachments=@artwork.zip'

Supported attachment formats include archives (zip, rar, 7z, tar, gz), spreadsheets (xlsx, xls, csv), documents (pdf, doc, docx), images (jpg, jpeg, png, gif, bmp, webp) and text (txt, json, xml). Attachments are stored with the order batch; they do not replace image URLs in the spreadsheet.

Options

Field	Default	Meaning
`templateId`	Required	Template ID from List Order Templates
`file`	Required	One Excel order list
`attachments`	None	Optional attachment files
`urlSplitToken`	`0`	`0`: pipe, `1`: semicolon, `2`: newline
`namingType`	`default`	`default`, `simple`, `random`, or `sku`
`needDownloadImage`	`true`	Enable asynchronous image downloads
`newImageDownload`	`false`	Use the new downloader when image downloads are enabled

Success and follow-up queries

{
  "success": true,
  "totalRows": 12,
  "mainOrderId": "1234567890123456789",
  "uniqueRequestId": "server-generated-batch-key",
  "errors": []
}

Save uniqueRequestId. Use it with Query Orders, Query Waybills and Query Trackings. A successful upload means the order batch was imported; factory matching, shipment creation and image downloads can still be pending.

Validation failures

If a row fails validation, HTTP 400 includes Excel row numbers. No orders from that file are committed:

{
  "success": false,
  "totalRows": 12,
  "mainOrderId": null,
  "uniqueRequestId": null,
  "errors": [
    { "rowIndex": 2, "errors": ["SKU validation failed"] }
  ]
}

Other request errors (such as an empty file, unsupported format, unavailable template or malformed workbook) return HTTP 400 with code, msg and optional data. Missing or invalid API keys return HTTP 401. Existing order numbers are rejected by the Excel import duplicate checks. The endpoint does not accept a client-generated idempotency key. If a request times out, check the order batch in the operator dashboard before uploading the same file again.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data

templateId

integer<int64>

required

Enabled order template ID from List Order Templates.

file

required

One non-empty .xlsx or .xls order file. Filename must contain the authenticated customer name; headers must match the selected template.

attachments

file[]

Optional attachments. Repeat the attachments multipart field for multiple files.

namingType

enum<string>

default:default

Available options:

default,

simple,

random,

sku

urlSplitToken

enum<string>

default:0

Image URL separator: 0 = pipe, 1 = semicolon, 2 = newline.

Available options:

0,

1,

2

needDownloadImage

boolean

default:true

Create asynchronous image download tasks. Set false to import orders only.

newImageDownload

boolean

default:false

Use the new image downloader. Ignored when needDownloadImage is false.

Response

Order batch imported; downstream processing may still be pending

success

boolean

required

totalRows

integer

required

errors

object[]

required

Show child attributes

mainOrderId

string | null

Created batch ID, encoded as a string to preserve precision.

uniqueRequestId

string | null

Server-generated batch key for Query Orders, Query Waybills and Query Trackings. Only returned on success.

API Documentation

Product Catalog

Order Management

Upload Order File

Prepare the order file

Example

Options

Success and follow-up queries

Validation failures

Authorizations

Body

Response

​Prepare the order file

​Example

​Options

​Success and follow-up queries

​Validation failures

Authorizations

Body

Response

Prepare the order file

Example

Options

Success and follow-up queries

Validation failures