Import an order from files or text

Imports order data from uploaded files or raw text using the internal ingestion flow.

POST/api/unstable/orders/imports/file

Imports order data from uploaded files or raw text using the internal ingestion flow.

Request Body

application/json

text?string

Raw pasted text describing the quote or order to import.

Example"2 Industrial Pump\\n1 Installation service"

fileIds?array<>

Uploaded files to parse into order items.

Example

[
  "file_123",
  "file_456"
]

instructions?string

Extra instructions for the import assistant.

Example"Group services under a separate section."

[key: string]?never

Response Body

`application/json`

curl -X POST "https://loading/api/unstable/orders/imports/file" \  -H "Content-Type: application/json" \  -d '{}'

{
  "tsv": "string",
  "items": [
    {
      "id": "item_123",
      "type": "product",
      "name": "Industrial Pump",
      "productId": "prod_123",
      "product": {
        "id": "prod_123",
        "title": "Industrial Pump",
        "sku": "PUMP-001"
      },
      "quantity": 2,
      "price": 12990,
      "originalPrice": {
        "priceListId": "pl_retail",
        "price": 12990,
        "currency": "CLP",
        "timestamp": "2026-03-11T10:15:00.000Z"
      },
      "taxes": [
        {
          "name": "VAT",
          "rate": 19,
          "type": "VAT",
          "calculation": "exclusive"
        }
      ],
      "baseUnit": {
        "type": "base",
        "code": "unit",
        "name": "Unit",
        "dimension": "count",
        "step": 1,
        "rounding": "nearest"
      },
      "alternativeUnit": {
        "type": "alternative",
        "code": "box",
        "name": "Box",
        "factor": 12,
        "dimension": "count",
        "rounding": "nearest"
      },
      "parentId": "item_bundle_1",
      "index": 0,
      "note": "Keep this line grouped with installation.",
      "mainImageSrc": "https://cdn.recerc.com/products/pump-001.png",
      "description": "Includes installation kit and calibration.",
      "customFields": {
        "installation_required": true
      },
      "calculatedFields": {
        "line_margin": 18.5
      },
      "tags": [
        {
          "name": "featured",
          "label": "Featured"
        }
      ],
      "priceReferenceUnit": 6495,
      "quantityReferenceUnit": 4,
      "referenceConversion": "1 box = 12 units",
      "referenceUnit": {
        "type": "alternative",
        "code": "box",
        "name": "Box",
        "factor": 12,
        "dimension": "count",
        "rounding": "nearest"
      },
      "pricingScope": "self"
    }
  ],
  "products": [
    {
      "id": "string",
      "sku": "string",
      "title": "string"
    }
  ]
}

{
  "issues": [
    {
      "_tag": "Pointer",
      "path": [
        "string"
      ],
      "message": "string"
    }
  ],
  "message": "string",
  "_tag": "HttpApiDecodeError"
}

Empty

{
  "message": "string",
  "_tag": "ApiForbiddenError"
}

{
  "message": "string",
  "_tag": "ApiNotFoundError"
}

{
  "message": "string",
  "_tag": "ApiConflictError"
}

{
  "message": "string",
  "_tag": "ApiUnprocessableEntityError"
}

Empty

{
  "message": "string",
  "_tag": "ApiTimeoutError"
}

Import an order from files or text

Request Body

Response Body

200application/json

400application/json

401

403application/json

404application/json

409application/json

422application/json

503

504application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`