> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.quivo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Create order

> Extract or export orders based on filters for reporting or integration use cases.



## OpenAPI

````yaml /openapi.json post /orders/extract
openapi: 3.0.1
info:
  title: Connector
  version: 80f7edc, 2026-01-23T12:01:00Z
  description: Enhanced Quivo API documentation with additional descriptions and examples
  contact:
    name: Quivo Support
    email: support@quivo.co
    url: https://quivo.co
  license:
    name: Proprietary
    url: https://quivo.co/terms
  termsOfService: https://quivo.co/terms
servers:
  - url: https://api.quivo.co/
    description: Production API server for Quivo Connector
security: []
tags:
  - name: addresses
    description: Manage stored addresses in the seller's address book
  - name: apiKeyRequests
    description: Request and manage API keys
  - name: articles
    description: Create and manage product articles
  - name: audits
    description: Access audit logs and history
  - name: bundles
    description: Manage product bundles
  - name: carriers
    description: Get carrier information
  - name: contacts
    description: Manage contact information
  - name: countries
    description: Get country information
  - name: currencies
    description: Get currency information
  - name: customerInquiries
    description: Manage customer inquiries
  - name: dashboards
    description: Access dashboard data
  - name: files
    description: Manage file uploads and downloads
  - name: fulfillmentPlans
    description: Manage fulfillment plans
  - name: inbounds
    description: Manage inbound shipments
  - name: items
    description: Monitor and manage inventory items
  - name: languages
    description: Get language information
  - name: notifications
    description: Manage notifications
  - name: orders
    description: Create and manage fulfillment orders
  - name: ping
    description: Health check endpoint
  - name: returnApp
    description: Manage return applications
  - name: returnLinks
    description: Manage return links
  - name: returns
    description: Manage returns
  - name: sellers
    description: Get seller information
  - name: shipments
    description: Book and manage shipments
  - name: shippingServiceGroups
    description: Get shipping service groups
  - name: shopOrders
    description: Manage shop orders
  - name: shops
    description: Manage shops
  - name: status
    description: Get system status
  - name: storedAddresses
    description: Manage stored addresses
  - name: subscriptionPackages
    description: Manage subscription packages
  - name: subscriptions
    description: Manage webhook subscriptions
  - name: track
    description: Track shipments
  - name: transports
    description: Manage transport services
  - name: users
    description: Manage users
  - name: warehouses
    description: Get warehouse information
paths:
  /orders/extract:
    post:
      tags:
        - orders
      summary: Create order
      description: >-
        Extract or export orders based on filters for reporting or integration
        use cases.
      operationId: orderPostExtract
      requestBody:
        content:
          application/octet-stream:
            schema:
              $ref: '#/components/schemas/InputStream'
        required: false
        description: Data to create a new resource at /orders/extract
      responses:
        '200':
          description: >-
            Returns the newly created OrderDetail with assigned identifiers and
            current state.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OrderDetail'
        '400':
          description: >-
            Bad request - the request payload is invalid, missing required
            fields, or contains invalid data.
        '401':
          description: >-
            Unauthorized - authentication credentials are missing, invalid, or
            expired.
        '404':
          description: >-
            Not found - the requested resource does not exist or is not
            accessible.
        '500':
          description: Internal server error - an unexpected error occurred on the server.
components:
  schemas:
    InputStream:
      type: object
      description: >-
        Request payload for extracting or exporting orders. Contains filter
        criteria and export configuration for retrieving order data in bulk.
    OrderDetail:
      type: object
      properties:
        orderId:
          type: integer
          format: int64
          description: The unique identifier for the order
        created:
          type: string
          format: date-time
          description: Timestamp when the item was created
        lastModified:
          type: string
          format: date-time
          description: Timestamp when the item was last modified
        orderIdentifier:
          type: string
          description: The unique identifier for the orderentifier
        orderReference:
          type: string
          description: Reference number or identifier for the order
        orderStatus:
          type: string
          description: The current status of the order
        orderDate:
          type: string
          format: date-time
          description: The order date date
        exportedAt:
          type: string
          format: date-time
          description: The exported at timestamp
        cancelRequestedAt:
          type: string
          format: date-time
          description: The cancel requested at timestamp
        completedAt:
          type: string
          format: date-time
          description: The completed at timestamp
        customerIdentifier:
          type: string
          description: The unique identifier for the customerentifier
        customerPurchaseOrderNumber:
          type: string
          description: Number value
        ssccLabel:
          type: boolean
          description: Boolean flag indicating sscc label
        sellerId:
          type: integer
          format: int64
          description: The unique identifier for the seller
        warehouseId:
          type: integer
          format: int64
          description: The unique identifier for the warehouse
        sellerName:
          type: string
          description: The name of the seller
        shopAvailableAt:
          type: string
          description: The shop available at
        shopActive:
          type: boolean
          description: Indicates whether the shop is active
        shopId:
          type: integer
          format: int64
          description: The unique identifier for the shop
        shopSystem:
          type: string
          description: The shop system
        shopSystemName:
          type: string
          description: The name of the shop system
        deliveryAddress:
          $ref: '#/components/schemas/DeliveryAddressDetail'
        invoiceAddress:
          $ref: '#/components/schemas/AddressDetail'
        currency:
          type: string
          description: Currency code
        positions:
          type: array
          items:
            $ref: '#/components/schemas/PositionDetail'
          description: Array of position items
        fulfillmentOrders:
          type: array
          items:
            $ref: '#/components/schemas/FulfillmentOrderDetail'
          description: Order identifier or information
        handlingUnits:
          type: array
          items:
            $ref: '#/components/schemas/HandlingUnitDetail'
          description: Array of handling unit
        earliestDeliveryDate:
          type: string
          format: date
          description: The earliest delivery date date
        latestDeliveryDate:
          type: string
          format: date
          description: The latest delivery date date
        comment:
          type: string
          description: Comment or notes
        transportInsuranceAmount:
          type: number
          description: Amount value
        cashOnDeliveryAmount:
          type: number
          description: Amount value
        cashOnDeliveryCurrency:
          type: string
          description: Currency code
        deliveryInstruction:
          type: string
          description: The delivery instruction
        shippingMethodIdentifier:
          type: string
          description: The unique identifier for the shippingmethodentifier
        shippingMethodName:
          type: string
          description: The name of the shipping method
        tags:
          type: array
          items:
            type: string
          description: Tags or labels
        earliestShipDate:
          type: string
          format: date
          description: The earliest ship date date
        latestShipDate:
          type: string
          format: date
          description: The latest ship date date
        piiDataRemoved:
          type: boolean
          description: Boolean flag indicating pii data removed
        paymentType:
          type: string
          description: The type or category of the payment
        trackingEnabled:
          type: boolean
          description: Indicates whether tracking is enabled
        orderPriority:
          type: integer
          format: int32
          description: Order identifier or information
        fulfillmentConfirmed:
          type: boolean
          description: Boolean flag indicating fulfillment confirmed
        entityErrors:
          type: array
          items:
            $ref: '#/components/schemas/EntityErrorDetail'
          description: Error information
        customAttributes:
          type: object
          additionalProperties:
            type: string
          description: Custom attributes or data
      description: >-
        Complete order information with all details. Contains order metadata,
        delivery address, item positions, fulfillment status, and related
        entities.
    DeliveryAddressDetail:
      type: object
      properties:
        name1:
          type: string
          description: The name of the item
        name2:
          type: string
          description: The name of the item
        company:
          type: string
          description: Company name
        address1:
          type: string
          description: Address information
        address2:
          type: string
          description: Address information
        address3:
          type: string
          description: Address information
        zip:
          type: string
          description: ZIP or postal code
        city:
          type: string
          description: City name
        state:
          type: string
          description: State or province
        country:
          type: string
          description: Country code or name
        phone:
          type: string
          description: Phone number
        email:
          type: string
          description: Email address
        addressIdentifier:
          type: string
          description: The unique identifier for the addressentifier
        additionalIdentifiers:
          type: array
          items:
            $ref: '#/components/schemas/OrderAddressAdditionalIdentifier'
          description: The unique identifier for the additionalentifiers
        latitude:
          type: number
          format: double
          description: The latitude numeric value
        longitude:
          type: number
          format: double
          description: The longitude numeric value
      description: Detailed delivery address information
    AddressDetail:
      type: object
      properties:
        name1:
          type: string
          description: The name of the item
        name2:
          type: string
          description: The name of the item
        company:
          type: string
          description: Company name
        address1:
          type: string
          description: Address information
        address2:
          type: string
          description: Address information
        address3:
          type: string
          description: Address information
        zip:
          type: string
          description: ZIP or postal code
        city:
          type: string
          description: City name
        state:
          type: string
          description: State or province
        country:
          type: string
          description: Country code or name
        phone:
          type: string
          description: Phone number
        email:
          type: string
          description: Email address
      description: Detailed address information
    PositionDetail:
      type: object
      properties:
        positionId:
          type: integer
          format: int64
          description: The unique identifier for the position
        positionIdentifier:
          type: string
          description: The unique identifier for the positionentifier
        name:
          type: string
          description: The name of the item
        sku:
          type: string
          description: Stock Keeping Unit (SKU) identifier
        customAttributes:
          type: object
          additionalProperties:
            type: string
          description: Custom attributes or data
        productIdentifier:
          type: string
          description: The unique identifier for the productentifier
        variantIdentifier:
          type: string
          description: The unique identifier for the variantentifier
        quantity:
          type: integer
          format: int32
          description: Quantity or amount
        lot:
          type: string
          description: The lot value
        location:
          type: string
          description: The location value
        bundledBy:
          type: string
          description: The bundled by
        unitWeight:
          type: number
          description: Weight value
        unitNetPrice:
          type: number
          description: Price value
        unitGrossPrice:
          type: number
          description: Price value
        totalWeight:
          type: number
          description: Weight value
        totalNetAmount:
          type: number
          description: Amount value
        totalGrossAmount:
          type: number
          description: Amount value
        expirationDate:
          type: string
          format: date-time
          description: The expiration date date
      description: Detailed information for position
    FulfillmentOrderDetail:
      type: object
      properties:
        warehouseId:
          type: integer
          format: int64
          description: The unique identifier for the warehouse
        warehouseName:
          type: string
          description: The name of the warehouse
        fulfillmentOrderId:
          type: integer
          format: int64
          description: The unique identifier for the fulfillmentorder
        fulfillmentOrderIdentifier:
          type: string
          description: The unique identifier for the fulfillmentorderentifier
        fulfillmentStatus:
          type: string
          description: The current status of the fulfillment
        fulfillmentConnectorStatus:
          type: string
          description: The current status of the fulfillment connector
        fulfillmentInStock:
          type: boolean
          description: Boolean flag indicating fulfillment in stock
        cancelled:
          type: boolean
          description: Indicates whether cancelled is enabled or active
        positions:
          type: array
          items:
            $ref: '#/components/schemas/FulfillmentOrderPositionDetail'
          description: Array of position items
        shipments:
          type: array
          items:
            $ref: '#/components/schemas/ShipmentDetail'
          description: Shipment identifier or information
        fulfillmentOrderCreated:
          type: string
          format: date-time
          description: Timestamp when the item was created
        inPicking:
          type: boolean
          description: Boolean flag indicating in picking
      description: Detailed fulfillment order information
    HandlingUnitDetail:
      type: object
      properties:
        type:
          type: string
          enum:
            - PALLET
            - CARTON
            - HALF_PALLET
            - ORDER
            - TRUCK
          description: The type or category of the item
        sscc:
          type: string
          description: The sscc value
        carrier:
          type: string
          description: Carrier identifier or information
        tracking:
          type: string
          description: Tracking information or tracking enabled status
        handlingUnitIdentifier:
          type: string
          description: The unique identifier for the handlingunitentifier
        truckHandlingUnitIdentifier:
          type: string
          description: The unique identifier for the truckhandlingunitentifier
        handlingPositions:
          type: array
          items:
            $ref: '#/components/schemas/HandlingUnitPositionDetail'
          description: Array of handling position
        childHandlingUnits:
          type: array
          items:
            $ref: '#/components/schemas/HandlingUnitDetail'
          description: Array of child handling unit
      description: Detailed information for handlingunit
    EntityErrorDetail:
      type: object
      properties:
        errorCode:
          type: string
          description: Code or identifier
        errorMessage:
          type: string
          description: Message content
      description: Detailed information for entityerror
    OrderAddressAdditionalIdentifier:
      type: object
      properties:
        identifier:
          type: string
          description: The specific identifier string (e.g., a GLN or store ID).
        type:
          type: string
          description: The type of the identifier (e.g., 'GLN', 'SHOP_SPECIFIC').
      description: >-
        Represents an additional, specialized identifier for an address, such as
        a GLN or a shop-specific ID, along with its type.
    FulfillmentOrderPositionDetail:
      type: object
      properties:
        fulfillmentOrderPositionId:
          type: integer
          format: int64
          description: The unique identifier for the fulfillmentorderposition
        orderedSku:
          type: string
          description: Stock Keeping Unit (SKU) identifier
        sku:
          type: string
          description: Stock Keeping Unit (SKU) identifier
        warehouseSku:
          type: string
          description: Stock Keeping Unit (SKU) identifier
        quantity:
          type: integer
          format: int32
          description: Quantity or amount
        lot:
          type: string
          description: The lot value
        location:
          type: string
          description: The location value
        customsValue:
          type: number
          description: The customs value value
        expirationDate:
          type: string
          format: date-time
          description: The expiration date date
        fulfillmentOrderPositionIdentifier:
          type: string
          description: The unique identifier for the fulfillmentorderpositionentifier
        bundleSku:
          type: string
          description: Stock Keeping Unit (SKU) identifier
      description: Fulfillment order position details
    ShipmentDetail:
      type: object
      properties:
        shipmentId:
          type: integer
          format: int64
          description: The unique identifier for the shipment
        shipmentIdentifier:
          type: string
          description: The unique identifier for the shipmententifier
        provider:
          type: string
          description: The provider value
        trackingLink:
          type: string
          description: Tracking information or tracking enabled status
        trackingLinks:
          type: array
          items:
            type: string
          description: Tracking information or tracking enabled status
        trackingNumber:
          type: string
          description: Tracking information or tracking enabled status
        trackingNumbers:
          type: array
          items:
            type: string
          description: Tracking information or tracking enabled status
        shipDate:
          type: string
          format: date-time
          description: The ship date date
        isUntracked:
          type: boolean
          description: Boolean flag indicating is untracked
        sscc:
          type: string
          description: The sscc value
        predatedShipment:
          type: string
          format: date
          description: The predated shipment date
        carrierPickUpDate:
          type: string
          format: date-time
          description: The carrier pick up date date
        deliveryWindowStartTime:
          type: string
          format: date-time
          description: Time value
        deliveryWindowEndTime:
          type: string
          format: date-time
          description: Time value
        providerName:
          type: string
          description: The name of the provider
        numberOfPallets:
          type: integer
          format: int32
          description: Number value
        numberOfParcels:
          type: integer
          format: int32
          description: Number value
        grossWeight:
          type: number
          description: Weight value
        width:
          $ref: '#/components/schemas/LengthMeasurementDetail'
        length:
          $ref: '#/components/schemas/LengthMeasurementDetail'
        height:
          $ref: '#/components/schemas/LengthMeasurementDetail'
        positions:
          type: array
          items:
            $ref: '#/components/schemas/ShipmentPositionDetail'
          description: Array of position items
        reversed:
          type: boolean
          description: Indicates whether reversed is enabled or active
        bookedShipmentId:
          type: integer
          format: int64
          description: The unique identifier for the bookedshipment
        expectedDeliveryDate:
          type: string
          format: date-time
          description: The expected delivery date date
        deliveryDate:
          type: string
          format: date-time
          description: The delivery date date
        podDate:
          type: string
          format: date-time
          description: The pod date date
        groupedPositions:
          type: array
          items:
            $ref: '#/components/schemas/GroupedShipmentPositionDetail'
          description: Array of grouped position
        podDocuments:
          type: array
          items:
            $ref: '#/components/schemas/PodDocumentGet'
          description: Array of pod document
      description: Detailed information for shipment
    HandlingUnitPositionDetail:
      type: object
      properties:
        sscc:
          type: string
          description: The sscc value
        positionIdentifier:
          type: string
          description: The unique identifier for the positionentifier
        sku:
          type: string
          description: Stock Keeping Unit (SKU) identifier
        warehouseSku:
          type: string
          description: Stock Keeping Unit (SKU) identifier
        quantity:
          type: integer
          format: int32
          description: Quantity or amount
      description: Detailed information for handlingunitposition
    LengthMeasurementDetail:
      type: object
      properties:
        value:
          type: number
          description: The value value
        unit:
          type: string
          enum:
            - M
            - DM
            - CM
            - MM
            - IN
          description: 'The unit. Possible values: M, DM, CM, MM, IN'
      description: Detailed information for lengthmeasurement
    ShipmentPositionDetail:
      type: object
      properties:
        shipmentPositionId:
          type: integer
          format: int64
          description: The unique internal identifier for the shipment position.
        sku:
          type: string
          description: The SKU used for the shipment position.
        warehouseSku:
          type: string
          description: The SKU as known in the warehouse system.
        sellerSku:
          type: string
          description: The original SKU from the seller.
        quantity:
          type: integer
          format: int32
          description: The quantity shipped in this position.
        lot:
          type: string
          description: The lot number of the item shipped.
        location:
          type: string
          description: The storage location where the item was picked from.
        expirationDate:
          type: string
          format: date-time
          description: The expiration date of the product shipped.
        serialNumbers:
          type: array
          items:
            type: string
          description: A list of serial numbers for tracked items.
        positionIdentifier:
          type: string
          description: The unique identifier for the shipment position.
      description: >-
        Detailed information about a specific item included within a shipment,
        including its allocated quantity, lot, location, and serial numbers.
    GroupedShipmentPositionDetail:
      type: object
      properties:
        warehouseSku:
          type: string
          description: Stock Keeping Unit (SKU) identifier
        sellerSku:
          type: string
          description: Stock Keeping Unit (SKU) identifier
        quantity:
          type: integer
          format: int32
          description: Quantity or amount
        lot:
          type: string
          description: The lot value
        expirationDate:
          type: string
          format: date-time
          description: The expiration date date
        serialNumbers:
          type: array
          items:
            type: string
          description: Number value
      description: Detailed information for groupedshipmentposition
    PodDocumentGet:
      type: object
      properties:
        fileName:
          type: string
          description: The name of the file
        fileKey:
          type: string
          description: Key or identifier
        url:
          $ref: '#/components/schemas/Link'
        mimeType:
          type: string
          description: The type or category of the mime
      description: Response object containing poddocument details
    Link:
      type: object
      properties:
        link:
          type: string
          description: Link or URL reference
      description: URL link reference. Contains link URL and optional metadata.

````