Request

Response

    Create Sales Order
    POST

    sales-orders

    Creates a new Sales Order.

    Resource Information

    Method and URI
    POST
    https://api.aps.autodesk.com/fusion-operations/v2/sales-orders
    Authentication Context
    No security required
    Required OAuth Scopes
    data:read data:write
    Data Format
    JSON

    Request

    Headers

    Authorization*
    string
    JWT Access Token
    Content-Type*
    string
    Must be application/json
    * Required

    Request

    Body Structure

    The Sales Order object to be created, conforming to the specified schema.

    Expand all
    code*
    string
    Sales Order code

    Max length: 255

    client
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    billingAddress
    Billing address for the Sales Order. Must be an address linked to the client. If not provided, the default billing address of the client will be used.
    anyOf
    Billing address for the Sales Order. Must be an address linked to the client. If not provided, the default billing address of the client will be used.
    0
    object
    code*
    string
    Address code

    Max length: 255

    name
    string
    Address name

    Max length: 255

    city
    string
    Address city

    Max length: 255

    street*
    string
    Address street
    postalCode
    string
    Address postal code
    state
    string
    Address state

    Max length: 255

    country*
    string
    Address country (ISO 3166-1 alpha-2 code)
    default
    boolean
    Is default address
    1
    all of
    0
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    createdAt*
    datetime: ISO 8601
    Creation date of the Sales Order (e.g. 2025-06-21T14:07:17Z)
    createdBy
    string
    Name of the integration if the Sales Order was created by an integration

    Max length: 255

    carrier
    string
    Code of the carrier handling the shipping

    Max length: 255

    trackingNumber
    string
    Max length: 255
    tax
    number
    observations
    string
    Max length: 4000
    notes
    string
    Max length: 5000
    externalNotes
    string
    Max length: 5000
    status
    enum:string
    Possible values: OPEN, CLOSED, ARCHIVED
    shippings*
    array: object
    code*
    string
    Shipping number

    Max length: 255

    dueDate
    datetime: ISO 8601
    Shipping due date (e.g. 2025-06-21T14:07:17Z)
    requestedDate
    datetime: ISO 8601
    Shipping requested date (e.g. 2025-06-21T14:07:17Z)
    deliveryAddress
    anyOf
    0
    object
    code*
    string
    Address code

    Max length: 255

    name
    string
    Address name

    Max length: 255

    city
    string
    Address city

    Max length: 255

    street*
    string
    Address street
    postalCode
    string
    Address postal code
    state
    string
    Address state

    Max length: 255

    country*
    string
    Address country (ISO 3166-1 alpha-2 code)
    default
    boolean
    Is default address
    shippingPrice
    number
    site
    Site associated with the Shipping.
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf
    Site associated with the Shipping.
    0
    1
    products*
    array: object
    product
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    variableParameters
    array: object
    name
    string
    value
    string
    quantityOrdered
    number
    price
    number
    observations
    string
    Max length: 2000
    trackingNumber
    string
    Max length: 255
    tax
    number
    discount
    number
    parameters
    array: object
    name*
    string
    value*
    string
    * Required

    Response

    HTTP Status Code Summary

    201
    Created
    Sales Order successfully created.
    400
    Bad Request
    Bad request due to invalid data.
    401
    Unauthorized
    The access token is invalid. It may have either expired or may not be a three-legged access token. Please verify the token and retry the request.
    403
    Forbidden
    The request was successfully validated but lacked required permission. Please verify your token permissions and retry the request.
    429
    Too Many Requests
    Rate limit exceeded; wait some time before retrying.
    500
    Internal Server Error
    An unknown server-side error occurred. Please try again later. If the problem persists, please contact support.

    Response

    Header (429)

    Retry-After
    integer
    The number of seconds to wait before retrying the request.

    Response

    Body Structure (201)

    Expand all
    id
    int
    Unique identifier of the Sales Order.
    code
    string
    Sales Order code

    Max length: 255

    client
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    name
    string
    Name of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    billingAddress
    Billing address for the Sales Order. Must be an address linked to the client. If not provided, the default billing address of the client will be used.
    anyOf
    Billing address for the Sales Order. Must be an address linked to the client. If not provided, the default billing address of the client will be used.
    0
    object
    id
    int
    Unique identifier of the address.
    code
    string
    Address code

    Max length: 255

    name
    string
    Address name

    Max length: 255

    city
    string
    Address city

    Max length: 255

    street
    string
    Address street
    postalCode
    string
    Address postal code
    state
    string
    Address state

    Max length: 255

    country
    string
    Address country (ISO 3166-1 alpha-2 code)
    default
    boolean
    Is default address
    1
    all of
    0
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    name
    string
    Name of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    createdAt
    datetime: ISO 8601
    Creation date of the Sales Order (e.g. 2025-06-21T14:07:17Z)
    createdBy
    string
    Name of the integration if the Sales Order was created by an integration

    Max length: 255

    carrier
    string
    Code of the carrier handling the shipping

    Max length: 255

    trackingNumber
    string
    Max length: 255
    price
    number
    tax
    number
    observations
    string
    Max length: 4000
    notes
    string
    Max length: 5000
    externalNotes
    string
    Max length: 5000
    status
    enum:string
    Possible values: OPEN, CLOSED, ARCHIVED
    shipped
    boolean
    shippings
    array: object
    id
    int
    Unique identifier of the shipping.
    code
    string
    Shipping number

    Max length: 255

    dueDate
    datetime: ISO 8601
    Shipping due date (e.g. 2025-06-21T14:07:17Z)
    requestedDate
    datetime: ISO 8601
    Shipping requested date (e.g. 2025-06-21T14:07:17Z)
    deliveryAddress
    anyOf
    0
    object
    id
    int
    Unique identifier of the address.
    code
    string
    Address code

    Max length: 255

    name
    string
    Address name

    Max length: 255

    city
    string
    Address city

    Max length: 255

    street
    string
    Address street
    postalCode
    string
    Address postal code
    state
    string
    Address state

    Max length: 255

    country
    string
    Address country (ISO 3166-1 alpha-2 code)
    default
    boolean
    Is default address
    shippingPrice
    number
    price
    number
    site
    Site associated with the Shipping.
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf
    Site associated with the Shipping.
    0
    1
    products
    array: object
    id
    int
    Unique identifier of the shipping product.
    product
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    name
    string
    Name of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    variableParameters
    array: object
    name
    string
    value
    string
    quantityOrdered
    number
    price
    number
    observations
    string
    Max length: 2000
    trackingNumber
    string
    Max length: 255
    tax
    number
    discount
    number
    quote
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    parameters
    array: object
    name
    string
    value
    string

    Example

    Sales Order successfully created.

    Request

    curl -v 'https://developer.api.autodesk.com/fusion-operations/v2/sales-orders' \
      -X 'POST' \
      -H 'Authorization: ' \
      -H 'Content-Type: application/json' \
      -d '{
            "code": "SO-1001",
            "client": {
              "code": "ClientA"
            },
            "billingAddress": {
              "id": 124
            },
            "createdAt": "2024-04-01T10:00:00Z",
            "createdBy": "MyShopIntegration",
            "carrier": "carrier_com",
            "trackingNumber": "TRACK123456",
            "price": 81.64,
            "tax": 5.3,
            "observations": "Please deliver between 9 AM and 5 PM.",
            "notes": "Handle with care.",
            "externalNotes": "Urgent delivery.",
            "status": "OPEN",
            "shipped": false,
            "shippings": [
              {
                "code": "Shipping001",
                "dueDate": "2024-04-10T10:00:00Z",
                "requestedDate": "2024-04-05T10:00:00Z",
                "deliveryAddress": {
                  "code": "Address code 1",
                  "name": "Address name 1",
                  "city": "City 1",
                  "street": "Street 1",
                  "postalCode": "12345",
                  "state": "State 1",
                  "country": "PT"
                },
                "shippingPrice": 25.24,
                "price": 51.1,
                "products": [
                  {
                    "id": 1,
                    "product": {
                      "code": "ProductA",
                      "name": "Product A 204"
                    },
                    "quantityOrdered": 1,
                    "price": 50.0,
                    "observations": "First product observation.",
                    "trackingNumber": "TRACKPROD1",
                    "tax": 6.1,
                    "discount": 5.0
                  }
                ],
                "site": {
                  "code": "SITE-01"
                }
              }
            ],
            "parameters": [
              {
                "name": "Voltage",
                "value": "220V"
              }
            ]
          }'
    
    Show More

    Response

    {
      "id": 382,
      "code": "SO-1001",
      "client": {
        "id": 12,
        "code": "ClientA",
        "name": "Client A"
      },
      "billingAddress": {
        "id": 124,
        "code": "Address code 1",
        "name": "Address name 1",
        "city": "City 1",
        "street": "Street 1",
        "postalCode": "12345",
        "state": "State 1",
        "country": "PT"
      },
      "createdAt": "2024-04-01T10:00:00Z",
      "createdBy": "MyShopIntegration",
      "carrier": "carrier_com",
      "trackingNumber": "TRACK123456",
      "price": 81.64,
      "tax": 5.3,
      "observations": "Please deliver between 9 AM and 5 PM.",
      "notes": "Handle with care.",
      "externalNotes": "Urgent delivery.",
      "status": "OPEN",
      "shipped": false,
      "shippings": [
        {
          "code": "Shipping001",
          "dueDate": "2024-04-10T10:00:00Z",
          "requestedDate": "2024-04-05T10:00:00Z",
          "deliveryAddress": {
            "id": 1,
            "code": "Address code 1",
            "name": "Address name 1",
            "city": "City 1",
            "street": "Street 1",
            "postalCode": "12345",
            "state": "State 1",
            "country": "PT",
            "default": true
          },
          "shippingPrice": 25.24,
          "price": 51.1,
          "products": [
            {
              "id": 1,
              "product": {
                "id": 21,
                "code": "ProductA",
                "name": "Product A 204"
              },
              "quantityOrdered": 1,
              "price": 50.0,
              "observations": "First product observation.",
              "trackingNumber": "TRACKPROD1",
              "tax": 6.1,
              "discount": 5.0
            }
          ],
          "site": {
            "id": 12,
            "code": "SITE-01"
          }
        }
      ],
      "quote": {
        "id": 55,
        "code": "QUOTE-2024-001"
      },
      "parameters": [
        {
          "name": "Voltage",
          "value": "220V"
        }
      ]
    }
    
    Show More