---
title: "Extract orders from a file exported by a shop system"
method: POST
path: "/orders/extract"
tags: ["orders"]
---

# Extract orders from a file exported by a shop system

`POST /orders/extract`

ADD ENDPOINT DESCRIPTION HERE

## Response `200`

successful operation

- OrderDetail[]
  - `orderId` integer
  - `created` string, date-time
  - `lastModified` string, date-time
  - `orderIdentifier` string
  - `orderReference` string
  - `orderStatus` string
  - `orderDate` string, date-time
  - `exportedAt` string, date-time
  - `cancelRequestedAt` string, date-time
  - `completedAt` string, date-time
  - `customerIdentifier` string
  - `customerPurchaseOrderNumber` string
  - `ssccLabel` boolean
  - `sellerId` integer
  - `warehouseId` integer
  - `sellerName` string
  - `shopAvailableAt` string
  - `shopActive` boolean
  - `shopId` integer
  - `shopSystem` string
  - `shopSystemName` string
  - `deliveryAddress` DeliveryAddressDetail
    - `name1` string
    - `name2` string
    - `company` string
    - `address1` string
    - `address2` string
    - `address3` string
    - `zip` string
    - `city` string
    - `state` string
    - `country` string
    - `phone` string
    - `email` string
    - `addressIdentifier` string
    - `additionalIdentifiers` OrderAddressAdditionalIdentifier[]
      - `identifier` string — The specific identifier string (e.g., a GLN or store ID).
      - `type` string — The type of the identifier (e.g., 'GLN', 'SHOP_SPECIFIC').
    - `latitude` number, double
    - `longitude` number, double
  - `invoiceAddress` AddressDetail
    - `name1` string
    - `name2` string
    - `company` string
    - `address1` string
    - `address2` string
    - `address3` string
    - `zip` string
    - `city` string
    - `state` string
    - `country` string
    - `phone` string
    - `email` string
  - `currency` string
  - `positions` PositionDetail[]
    - `positionId` integer
    - `positionIdentifier` string
    - `name` string
    - `sku` string
    - `customAttributes` object
    - `productIdentifier` string
    - `variantIdentifier` string
    - `quantity` integer
    - `lot` string
    - `location` string
    - `bundledBy` string
    - `unitWeight` number
    - `unitNetPrice` number
    - `unitGrossPrice` number
    - `totalWeight` number
    - `totalNetAmount` number
    - `totalGrossAmount` number
    - `expirationDate` string, date-time
  - `fulfillmentOrders` FulfillmentOrderDetail[]
    - `warehouseId` integer
    - `warehouseName` string
    - `fulfillmentOrderId` integer
    - `fulfillmentOrderIdentifier` string
    - `fulfillmentStatus` string
    - `fulfillmentConnectorStatus` string
    - `fulfillmentInStock` boolean
    - `cancelled` boolean
    - `positions` FulfillmentOrderPositionDetail[]
      - `fulfillmentOrderPositionId` integer
      - `orderedSku` string
      - `sku` string
      - `warehouseSku` string
      - `quantity` integer
      - `lot` string
      - `location` string
      - `customsValue` number
      - `expirationDate` string, date-time
      - `fulfillmentOrderPositionIdentifier` string
      - `bundleSku` string
    - `shipments` ShipmentDetail[]
      - `shipmentId` integer
      - `shipmentIdentifier` string
      - `provider` string
      - `trackingLink` string
      - `trackingLinks` string[]
      - `trackingNumber` string
      - `trackingNumbers` string[]
      - `shipDate` string, date-time
      - `isUntracked` boolean
      - `sscc` string
      - `predatedShipment` string, date
      - `carrierPickUpDate` string, date-time
      - `deliveryWindowStartTime` string, date-time
      - `deliveryWindowEndTime` string, date-time
      - `providerName` string
      - `numberOfPallets` integer
      - `numberOfParcels` integer
      - `grossWeight` number
      - `width` LengthMeasurementDetail
        - `value` number
        - `unit` 'M' | 'DM' | 'CM' | 'MM' | 'IN'
      - `length` LengthMeasurementDetail
        - `value` number
        - `unit` 'M' | 'DM' | 'CM' | 'MM' | 'IN'
      - `height` LengthMeasurementDetail
        - `value` number
        - `unit` 'M' | 'DM' | 'CM' | 'MM' | 'IN'
      - `positions` ShipmentPositionDetail[]
        - `shipmentPositionId` integer — The unique internal identifier for the shipment position.
        - `sku` string — The SKU used for the shipment position.
        - `warehouseSku` string — The SKU as known in the warehouse system.
        - `sellerSku` string — The original SKU from the seller.
        - `quantity` integer — The quantity shipped in this position.
        - `lot` string — The lot number of the item shipped.
        - `location` string — The storage location where the item was picked from.
        - `expirationDate` string, date-time — The expiration date of the product shipped.
        - `serialNumbers` string[] — A list of serial numbers for tracked items.
        - `positionIdentifier` string — The unique identifier for the shipment position.
      - `reversed` boolean
      - `bookedShipmentId` integer
      - `expectedDeliveryDate` string, date-time
      - `deliveryDate` string, date-time
      - `podDate` string, date-time
      - `groupedPositions` GroupedShipmentPositionDetail[]
        - `warehouseSku` string
        - `sellerSku` string
        - `quantity` integer
        - `lot` string
        - `expirationDate` string, date-time
        - `serialNumbers` string[]
      - `podDocuments` PodDocumentGet[]
        - `fileName` string
        - `fileKey` string
        - `url` Link
          - `link` string
        - `mimeType` string
    - `fulfillmentOrderCreated` string, date-time
    - `inPicking` boolean
  - `handlingUnits` HandlingUnitDetail[]
    - `type` 'PALLET' | 'CARTON' | 'HALF_PALLET' | 'ORDER' | 'TRUCK'
    - `sscc` string
    - `carrier` string
    - `tracking` string
    - `handlingUnitIdentifier` string
    - `truckHandlingUnitIdentifier` string
    - `handlingPositions` HandlingUnitPositionDetail[]
      - `sscc` string
      - `positionIdentifier` string
      - `sku` string
      - `warehouseSku` string
      - `quantity` integer
    - `childHandlingUnits` HandlingUnitDetail[]
  - `earliestDeliveryDate` string, date
  - `latestDeliveryDate` string, date
  - `comment` string
  - `transportInsuranceAmount` number
  - `cashOnDeliveryAmount` number
  - `cashOnDeliveryCurrency` string
  - `deliveryInstruction` string
  - `shippingMethodIdentifier` string
  - `shippingMethodName` string
  - `tags` string[]
  - `earliestShipDate` string, date
  - `latestShipDate` string, date
  - `piiDataRemoved` boolean
  - `paymentType` string
  - `trackingEnabled` boolean
  - `orderPriority` integer
  - `fulfillmentConfirmed` boolean
  - `entityErrors` EntityErrorDetail[]
    - `errorCode` string
    - `errorMessage` string
  - `customAttributes` object

---

[API](https://skmtc.net/writechoiceorg/apis/connector.md) · [All operations](https://skmtc.net/writechoiceorg/apis/connector/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/writechoiceorg/connector/versions/7ce09a4b2a4e/schema)