Fusion Operations API

https://fusionoperations.autodesk.com/api-documentation
Admin
Fusion Operations API is a manufacturing operations platform by Autodesk that provides easy access...
Tokens:90,758
Snippets:367
Trust Score:9.7
Update:6 months ago
Show doc for...
Tokens:
Raw
### Create Product File JavaScript Example

Source: https://fusionoperations.autodesk.com/api-documentation

This JavaScript example demonstrates how to create a product file using XMLHttpRequest. It requires a file input and an access token.

```javascript
var data = new FormData();
data.append("file", fileInput.files[0], "/path/to/your/file.ext");

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
if(this.readyState === 4) {
  console.log(this.responseText);
}
});

xhr.open("POST", 'https://fusionoperations.autodesk.com/api/v1/products/{code}/files?access_token=xxx');
xhr.send(data);
```

--------------------------------

### Get Task Duration Example URI

Source: https://fusionoperations.autodesk.com/api-documentation

Example URI for retrieving a specific task duration. Replace placeholders with actual IDs and access token.

```http
GET /api/v1/products/productId/operations/operationId/task-durations/taskDurationId?access_token=
```

--------------------------------

### List Production Orders Example URI

Source: https://fusionoperations.autodesk.com/api-documentation

Example URI for listing production orders. This endpoint supports filtering by various parameters and requires an access token with the 'productions_write' scope. The service is paginated.

```http
GET /api/v1/production-orders/?access_token=
```

--------------------------------

### Product JSON Structure

Source: https://fusionoperations.autodesk.com/api-documentation

Example JSON object representing a product with operations and parameters.

```json
{
  "code": "P11",
  "name": "Product 11",
  "section": null,
  "families": null,
  "color": "#8b0000",
  "observations": "observations",
  "standard-uom": {
    "code": "KG",
    "name": "kg"
  },
  "operations": [
    {
      "code": "op1",
      "name": "op1",
      "waste": null,
      "task-durations": [
        {
          "validSince": "01/01/2022 - 13:00",
          "validUntil": "01/01/2100 - 13:00",
          "duration": "00H01m00s",
          "duration-customer": "00H01m00s",
          "ratio-quantity": 1
        }
      ],
      "custom-fields": null,
      "machines": null,
      "disabled": false,
      "optional": false,
      "recovery": null,
      "no-time": false,
      "no-quantity": false,
      "as-team": false,
      "max-waste-threshold": null,
      "section": {
        "name": "specialsection"
      },
      "id": 100
    }
  ],
  "custom-fields": null,
  "parameters": [
    {
      "name": "parameter1",
      "value": "value1"
    },
    {
      "name": "parameter2",
      "value": "2022-12-19T00:00:00Z"
    },
    {
      "name": "parameter3",
      "value": 1
    }
  ],
  "label": {
    "code": "labelCode"
  },
  "serializable": true
}
```

--------------------------------

### Update Task Duration Example URI

Source: https://fusionoperations.autodesk.com/api-documentation

Example URI for updating a specific task duration. Replace placeholders with actual IDs and access token.

```http
PATCH /api/v1/products/productId/operations/operationId/task-durations/taskDurationId?access_token=
```

--------------------------------

### Changes Feed Channel - Get Changes Example URI

Source: https://fusionoperations.autodesk.com/api-documentation

Example URI for fetching changes from a specific channel. The `access_token` is required, and `workers` is an optional parameter for the Production Orders channel.

```http
GET /api/v1/changes/channel?access_token=
```

--------------------------------

### Retrieve a Product File

Source: https://fusionoperations.autodesk.com/api-documentation

Use this endpoint to get details of a specific product file. Requires an access token with the 'productions_write' scope.

```http
GET /api/v1/products/{code}/files/{file_id}{?access_token}
```

```http
GET /api/v1/products/code/files/file_id?access_token=
```

```json
{
  "id": 1,
  "name": "file_name.xlsx",
  "creation-date": "2025-01-25T08:30:01Z",
  "size": 128,
  "show-on-tablet": false
}
```

--------------------------------

### Create Product File cURL Example

Source: https://fusionoperations.autodesk.com/api-documentation

Use this cURL command to create a single file for a product. Ensure you have the correct access token with 'productions_write' scope.

```bash
curl --location 'https://fusionoperations.autodesk.com/api/v1/products/{code}/files?access_token=xxx' \
   --form 'file=@"/path/to/your/file.ext"'
```

--------------------------------

### Create Purchase Order File Request

Source: https://fusionoperations.autodesk.com/api-documentation

Examples for uploading a file to a purchase order using cURL or JavaScript.

```bash
curl --location 'https://fusionoperations.autodesk.com/api/v1/purchase-orders/{id}/files?access_token=xxx' \
   --form 'file=@"/path/to/your/file.ext"'
```

```javascript
var data = new FormData();
data.append("file", fileInput.files[0], "/path/to/your/file.ext");

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
if(this.readyState === 4) {
  console.log(this.responseText);
}
});

xhr.open("POST", 'https://fusionoperations.autodesk.com/api/v1/purchase-orders/{id}/files?access_token=xxx');
xhr.send(data);
```

--------------------------------

### Create Authorization Request

Source: https://fusionoperations.autodesk.com/api-documentation

Example headers and body for generating a new access token via POST.

```http
Content-Type: application/json  
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
```

```json
{
  "scopes": [
    "productions_write"
  ]
}
```

--------------------------------

### GET /api/v1/products/{code}/files/{file_id}

Source: https://fusionoperations.autodesk.com/api-documentation

Retrieves details of a specific product file. Requires an access_token with productions_write scope.

```APIDOC
## GET /api/v1/products/{code}/files/{file_id}

### Description
Retrieve a Product file. This action requires an access_token with productions_write scope.

### Method
GET

### Endpoint
/api/v1/products/{code}/files/{file_id}{?access_token}

### Parameters
#### Path Parameters
- **code** (string) - Required - Product code.
- **file_id** (numeric) - Required - Product File ID.

#### Query Parameters
- **access_token** (string) - Required - Fusion Operations API access token.

### Response
#### Success Response (200)
- **id** (numeric) - File ID
- **name** (string) - File name
- **creation-date** (string) - Creation date
- **size** (numeric) - File size
- **show-on-tablet** (boolean) - Active status on the tablet

#### Response Example
{
  "id": 1,
  "name": "file_name.xlsx",
  "creation-date": "2025-01-25T08:30:01Z",
  "size": 128,
  "show-on-tablet": false
}
```

--------------------------------

### GET /api/v1/production-orders/{id}/files

Source: https://fusionoperations.autodesk.com/api-documentation

Lists all files associated with a specific production order.

```APIDOC
## GET /api/v1/production-orders/{id}/files

### Description
Retrieves a list of all files linked to the specified production order.

### Method
GET

### Endpoint
/api/v1/production-orders/{id}/files

### Parameters
#### Path Parameters
- **id** (numeric) - Required - Production Order ID.

#### Query Parameters
- **access_token** (string) - Required - Fusion Operations API access token.

### Response
#### Success Response (200)
- **Array** (object) - List of file objects containing id, name, creation-date, size, and show-on-tablet.

#### Response Example
[
  {
    "id": 1,
    "name": "file_name.xlsx",
    "creation-date": "2025-01-25T08:30:01Z",
    "size": 128,
    "show-on-tablet": false
  }
]
```

--------------------------------

### GET /api/v1/products/{code}/files

Source: https://fusionoperations.autodesk.com/api-documentation

Retrieves a list of files associated with a specific product. Requires an access_token with productions_write scope.

```APIDOC
## GET /api/v1/products/{code}/files

### Description
Retrieves a list of all files associated with the specified product code.

### Method
GET

### Endpoint
/api/v1/products/{code}/files

### Parameters
#### Path Parameters
- **code** (string) - Required - Product code.

#### Query Parameters
- **access_token** (string) - Required - Fusion Operations API access token.

### Response
#### Success Response (200)
- **id** (integer) - File ID
- **name** (string) - File name
- **creation-date** (string) - Creation timestamp
- **size** (integer) - File size
- **show-on-tablet** (boolean) - Tablet visibility flag

#### Response Example
[
  {
    "id": 1,
    "name": "file_name.xlsx",
    "creation-date": "2025-01-25T08:30:01Z",
    "size": 128,
    "show-on-tablet": false
  },
  {
    "id": 2,
    "name": "file_name.pdf",
    "creation-date": "2025-01-25T08:30:01Z",
    "size": 128,
    "show-on-tablet": true
  }
]
```

--------------------------------

### Retrieve Authorization Response Headers and Body

Source: https://fusionoperations.autodesk.com/api-documentation

Example response headers and JSON body returned when successfully retrieving an authorization token.

```http
Content-Type: application/hal+json  
Link: <https://fusionoperations.autodesk.com/api/v1/authorization>;rel="self"
```

```json
{
      "_links": {
          "self": { "href": "/api/v1/authorization" },
      },
      "scopes": [
          "productions_write"
      ],
      "token": "abc123"
  }
```

--------------------------------

### Retrieve Authorization Request Headers

Source: https://fusionoperations.autodesk.com/api-documentation

Example of the Authorization header required for retrieving an existing access token.

```http
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
```

--------------------------------

### Create Task Duration Request Body

Source: https://fusionoperations.autodesk.com/api-documentation

Example JSON body for creating a new task duration. Ensure all required fields are present.

```json
{
  "id": 12,
  "validSince": "2025-08-10",
  "cycleTime": "PT1H30M00S",
  "customerTime": "PT1H15M00S",
  "quantityRatio": 1.1
}
```

--------------------------------

### Sales Order Files Response Body

Source: https://fusionoperations.autodesk.com/api-documentation

Example JSON response body containing a list of file objects associated with a Sales Order.

```json
[
  {
    "id": 1,
    "name": "file_name.xlsx",
    "creation-date": "2025-01-25T08:30:01Z",
    "size": 128,
    "show-on-tablet": false
  },
  {
    "id": 2,
    "name": "file_name.pdf",
    "creation-date": "2025-01-25T08:30:01Z",
    "size": 128,
    "show-on-tablet": true
  }
]
```

--------------------------------

### Get Task Duration Response Body (200 OK)

Source: https://fusionoperations.autodesk.com/api-documentation

Example JSON response for a successful retrieval of a task duration. Includes details like validSince, cycleTime, customerTime, and quantityRatio.

```json
{
  "id": 1,
  "validSince": "2021-04-03",
  "cycleTime": "PT3H15M30S",
  "customerTime": "PT2H55M10S",
  "quantityRatio": 1.25
}
```

--------------------------------

### Delete Task Duration Example URI

Source: https://fusionoperations.autodesk.com/api-documentation

Example URI for deleting a specific task duration. Replace placeholders with actual IDs and access token.

```http
DELETE /api/v1/products/productId/operations/operationId/task-durations/taskDurationId?access_token=
```

--------------------------------

### POST /api/v1/products/{code}/files

Source: https://fusionoperations.autodesk.com/api-documentation

Creates a new file for a specific product. Requires an access_token with productions_write scope.

```APIDOC
## POST /api/v1/products/{code}/files

### Description
Creates a new file for a specific product. Only one file can be created per request.

### Method
POST

### Endpoint
/api/v1/products/{code}/files

### Parameters
#### Path Parameters
- **code** (string) - Required - URL encoded Product's code.

#### Query Parameters
- **access_token** (string) - Required - Fusion Operations API access token.

### Request Body
- **file** (binary) - Required - The file to be uploaded using multipart/form-data.

### Response
#### Success Response (201)
- **id** (integer) - File ID
- **name** (string) - File name
- **creation-date** (string) - Creation timestamp
- **size** (integer) - File size
- **show-on-tablet** (boolean) - Tablet visibility flag

#### Response Example
{
  "id": 1,
  "name": "file_name.xlsx",
  "creation-date": "2025-01-25T08:30:01Z",
  "size": 128,
  "show-on-tablet": false
}
```

--------------------------------

### Create Product Success Response

Source: https://fusionoperations.autodesk.com/api-documentation

JSON response returned upon successful product creation.

```json
{
  "code": "P11",
  "name": "Product 11",
  "families": [
    {
      "code": "FG"
    }
  ],
  "color": "#8b0000",
  "observations": "observations",
  "standard-uom": {
    "code": "KG",
    "name": "kg",
    "id": 4
  },
  "operations": [
    {
      "code": "op1",
      "name": "op1",
      "waste": [
        {
          "code": "BROKEN"
        }
      ],
      "task-durations": [
        {
          "validSince": "01/01/2022 - 13:00",
          "validUntil": "01/01/2100 - 13:00",
          "duration": "00H01m00s",
          "duration-customer": "00H01m00s",
          "ratio-quantity": 1
        }
      ],
      "times-per-product": 2,
      "checklists": [
        {
          "code": "CheckIn"
        }
      ],
      "machines": [
        {
          "code": "OVEN02"
        }
      ],
      "disabled": false,
      "optional": false,
      "recovery": false,
      "no-time": false,
      "no-quantity": false,
      "as-team": false,
      "multi-po": false,
      "print-production-barcode": false,
      "prepare-batch-order": false,
      "section": {
        "name": "CUT"
      }
    }
  ],
  "custom-fields": null,
  "parameters": [
    {
      "name": "parameter1",
      "value": "value1"
    },
    {
      "name": "parameter2",
      "value": "2022-12-19T00:00:00Z"
    }
  ],
  "serializable": true
}
```

--------------------------------

### Worker Labor Time Report Example URI

Source: https://fusionoperations.autodesk.com/api-documentation

Example URI for retrieving the worker labor time report. Requires start-time, end-time, and an access token. Optional parameters can filter and customize the report.

```http
GET /api/v1/reports/worker-labor-time?access_token=
```

--------------------------------

### GET /api/v1/inventory-movements

Source: https://fusionoperations.autodesk.com/api-documentation

Lists inventory movements with optional filtering and pagination.

```APIDOC
## GET /api/v1/inventory-movements

### Description
Lists Inventory Movements. Multiple parameters are treated as an AND condition. Requires an access_token with productions_write scope. Paginated, 25 items per page.

### Method
GET

### Endpoint
/api/v1/inventory-movements/?access_token={access_token}

### Parameters
#### Query Parameters
- **access_token** (string) - Required - Fusion Operations API access token.
- **page** (numeric) - Optional - Result page index, starting at 1.
- **product-code** (string) - Optional - Product Code.
- **type** (string) - Optional - Inventory movement type: in, out, consumption, production.
```

--------------------------------

### Create Product Family Response Body

Source: https://fusionoperations.autodesk.com/api-documentation

Successful response body returned after creating product families.

```json
[
  {
    "code": "FAM 1",
    "name": "Family 1"
  },
  {
    "code": "FAM 2",
    "name": "Family 2"
  }
]
```

--------------------------------

### GET /api/v1/clients/{id}

Source: https://fusionoperations.autodesk.com/api-documentation

Retrieves the details of a specific client by their ID.

```APIDOC
## GET /api/v1/clients/{id}

### Description
Retrieve a specific client by their unique identifier.

### Method
GET

### Endpoint
/api/v1/clients/{id}

### Parameters
#### Path Parameters
- **id** (numeric) - Required - Client ID

#### Query Parameters
- **access_token** (string) - Required - Fusion Operations API access token.

### Response
#### Success Response (200)
- **client** (object) - The client details.
```

--------------------------------

### GET /api/v1/authorization

Source: https://fusionoperations.autodesk.com/api-documentation

Retrieve an existing access token for the authenticated company.

```APIDOC
## GET /api/v1/authorization

### Description
Retrieve an existing access token. If a token does not exist, one can be generated using the POST method.

### Method
GET

### Endpoint
/api/v1/authorization

### Request Example
Authorization: Basic <base64 encoded API_KEY:API_SECRET>

### Response
#### Success Response (200)
- **token** (string) - The access token.
- **scopes** (array) - List of granted scopes.

#### Response Example
{
  "_links": {
    "self": { "href": "/api/v1/authorization" }
  },
  "scopes": ["productions_write"],
  "token": "abc123"
}
```

--------------------------------

### GET /api/v1/inventory-movements/{id}

Source: https://fusionoperations.autodesk.com/api-documentation

Retrieves details for a single inventory movement by its ID.

```APIDOC
## GET /api/v1/inventory-movements/{id}

### Description
To retrieve an Inventory Movement simply perform a GET request with the id of the Inventory Movement. This action requires an access_token with productions_write scope.

### Method
GET

### Endpoint
/api/v1/inventory-movements/{id}

### Parameters
#### Path Parameters
- **id** (numeric) - Required - Inventory Movement ID.

#### Query Parameters
- **access_token** (string) - Required - Fusion Operations API access token.

### Response
#### Success Response (200)
- **product-code** (string) - Product Code
- **date-time** (date) - Date when inventory movement is created
- **quantity** (double) - Inventory movement quantity
- **type** (string) - Inventory movement type: in, out, consumption, production
- **lot** (string) - Inventory movement lot
- **total-cost** (bigdecimal) - Inventory movement total cost
- **comment** (string) - Inventory movement comment

#### Response Example
{
  "product-code": "ProductCode",
  "date-time": "2018-07-20T09:15:15Z",
  "quantity": "10",
  "type": "in",
  "lot": "A",
  "total-cost": "1000",
  "comment": "OK"
}
```

--------------------------------

### Example Product Inventory Response

Source: https://fusionoperations.autodesk.com/api-documentation

This JSON object represents a successful response when retrieving product inventory. It includes the product code, total stock, and a breakdown of stock by lot.

```json
[
  {
    "product-code": "ProductCode",
    "date-time": "2018-07-20T09:15:15Z",
    "quantity": "10",
    "type": "in",
    "lot": "A",
    "total-cost": "1000",
    "comment": "OK",
    "warehouse-location": "Zone2",
    "id": 12345,
    "shipping": {
      "code": "shippingCode",
      "clientOrder": {
        "code": "clientOrderCode",
        "client": "clientCode"
      },
      "location": {
        "id": "location id",
        "code": "location code",
        "name": "location name"
      }
    },
    "receiving": {
      "code": "receivingCode",
      "purchaseOrder": {
        "code": "purchaseOrderCode",
        "supplier": "supplierCode"
      },
      "location": {
        "id": "location id",
        "code": "location code",
        "name": "location name"
      }
    }
  }
]
```

```json
{
  "product-code": "Example",
  "stock": 35,
  "lot": [
    {
      "code": "A",
      "stock": 10
    },
    {
      "code": "B",
      "stock": 5
    }
  ]
}
```

--------------------------------

### Production Created Webhook

Source: https://fusionoperations.autodesk.com/api-documentation

Triggered when a production starts, excluding operations with no time.

```text
x-prodsmart-topic: production_created
```

```json
{
    "production-order": {
    "code": "Table_2",
    "id": 987
  },
  "operation": {
    "code": "Paint"
  },
  "product": {
    "id": 123,
    "code": "Table"
  },
  "worker": {
    "id": 20804,
    "number": 0,
    "name": "Zero"
  },
  "machine": {},
  "quantity": 7,
  "finished": true,
  "lot": {},
  "cost": 0,
  "produced-waste": [],
  "parameters": [],
  "consumptions": [
    {
      "product": {
        "id": 333,
        "code": "RawMaterial"
      },
      "lot": {},
      "date": "2023-12-21T11:39:43.000Z",
      "quantity": 7,
      "cost": 0,
      "id": 222
    }
  ],
  "total-time-factor": 1,
  "rework": false,
  "start-time": "2023-12-21T11:39:43.000Z",
  "end-time": "2023-12-21T11:39:43.000Z",
  "is-serializable": false,
  "id": 111
}
```

--------------------------------

### GET /api/v1/downtimes

Source: https://fusionoperations.autodesk.com/api-documentation

Retrieves a list of downtime events based on specified filter criteria.

```APIDOC
## GET /api/v1/downtimes

### Description
List Downtimes. Multiple parameters will be treated as an AND condition. This action requires an access_token with productions_write scope.

### Method
GET

### Endpoint
/api/v1/downtimes

### Parameters
#### Query Parameters
- **access_token** (string) - Required - Fusion Operations API access token.
- **page** (numeric) - Optional - result page index, starting in 1
- **start-time-before** (date) - Optional - List downtimes with start time before this
- **start-time-after** (date) - Optional - List downtimes orders with start time after this
- **end-time-before** (date) - Optional - List downtimes with end time before this
- **end-time-after** (date) - Optional - List downtimes with end time after this
- **machine** (numeric) - Optional - List downtimes on this machine

### Response
#### Success Response (200)
- **Array** (object) - A list of downtime objects.
```

--------------------------------

### Create Production Order File

Source: https://fusionoperations.autodesk.com/api-documentation

Upload a file to a production order. Requires an access token with 'productions_write' scope. Only one file can be created per request.

```bash
curl --location 'https://fusionoperations.autodesk.com/api/v1/production-orders/{id}/files?access_token=xxx' \
   --form 'file=@"/path/to/your/file.ext"'
```

--------------------------------

### Create Product API

Source: https://fusionoperations.autodesk.com/api-documentation

This endpoint allows for the creation of a new product with its associated operations. It requires an access token with the 'productions_write' scope. Multiple operations can be created simultaneously.

```APIDOC
## POST /api/v1/products/

### Description
To create a Product provide a JSON hash of the attributes for the new Product and its Operations. This action requires an access_token with productions_write scope. Multiple Operations can be created at once.

### Method
POST

### Endpoint
/api/v1/products/

### Parameters
#### Query Parameters
- **access_token** (string) - Required - Fusion Operations API access token.

### Request Body
- **code** (string) - Required - The code for the product.
- **name** (string) - Required - The name of the product.
- **families** (array) - Optional - An array of family objects, each with a 'code' field.
- **color** (string) - Optional - The color of the product in hex format.
- **observations** (string) - Optional - Any observations related to the product.
- **standard-uom** (object) - Required - The standard unit of measure for the product, containing a 'code' field.
- **operations** (array) - Required - An array of operation objects to be associated with the product.
  - **code** (string) - Required - The code for the operation.
  - **name** (string) - Required - The name of the operation.
  - **waste** (array) - Optional - An array of waste objects, each with a 'code' field.
  - **task-durations** (array) - Required - An array of task duration objects.
    - **validSince** (string) - Required - The start date and time for the task duration validity.
    - **validUntil** (string) - Required - The end date and time for the task duration validity.
    - **duration** (string) - Required - The duration of the task in HH:MM:SS format.
    - **duration-customer** (string) - Required - The customer-facing duration of the task.
    - **ratio-quantity** (number) - Required - The quantity ratio for the task duration.
  - **times-per-product** (number) - Optional - The number of times this operation is performed per product.
  - **checklists** (array) - Optional - An array of checklist objects, each with a 'code' field.
  - **machines** (array) - Optional - An array of machine objects, each with a 'code' field.
  - **disabled** (boolean) - Optional - Indicates if the operation is disabled.
  - **optional** (boolean) - Optional - Indicates if the operation is optional.
  - **recovery** (boolean) - Optional - Indicates if the operation involves recovery.
  - **no-time** (boolean) - Optional - Indicates if the operation does not require time.
  - **no-quantity** (boolean) - Optional - Indicates if the operation does not require quantity.
  - **as-team** (boolean) - Optional - Indicates if the operation is performed as a team.
  - **multi-po** (boolean) - Optional - Indicates if the operation supports multiple production orders.
  - **print-production-barcode** (boolean) - Optional - Indicates if production barcodes should be printed.
  - **prepare-batch-order** (boolean) - Optional - Indicates if batch orders should be prepared.
  - **section** (object) - Optional - The section the operation belongs to, containing a 'name' field.
- **custom-fields** (object) - Optional - Custom fields for the product.
- **parameters** (array) - Optional - An array of parameter objects, each with 'name' and 'value' fields.
- **serializable** (boolean) - Optional - Indicates if the product is serializable.

### Request Example
```json
{
  "code": "P11",
  "name": "Product 11",
  "families": [
    {
      "code": "FG"
    }
  ],
  "color": "#8b0000",
  "observations": "observations",
  "standard-uom": {
    "code": "KG"
  },
  "operations": [
    {
      "code": "op1",
      "name": "op1",
      "waste": [
        {
          "code": "BROKEN"
        }
      ],
      "task-durations": [
        {
          "validSince": "01/01/2022 - 13:00",
          "validUntil": "01/01/2100 - 13:00",
          "duration": "00H01m00s",
          "duration-customer": "00H01m00s",
          "ratio-quantity": 1
        }
      ],
      "times-per-product": 2,
      "checklists": [
        {
          "code": "CheckIn"
        }
      ],
      "machines": [
        {
          "code": "OVEN02"
        }
      ],
      "disabled": false,
      "optional": false,
      "recovery": false,
      "no-time": false,
      "no-quantity": false,
      "as-team": false,
      "multi-po": false,
      "print-production-barcode": false,
      "prepare-batch-order": false,
      "section": {
        "name": "CUT"
      }
    }
  ],
  "custom-fields": null,
  "parameters": [
    {
      "name": "parameter1",
      "value": "value1"
    },
    {
      "name": "parameter2",
      "value": "2022-12-19T00:00:00Z"
    }
  ],
  "serializable": true
}
```

### Response
#### Success Response (201)
- **code** (string) - The code of the created product.
- **name** (string) - The name of the created product.
- **families** (array) - An array of family objects.
- **color** (string) - The color of the product.
- **observations** (string) - Observations related to the product.
- **standard-uom** (object) - The standard unit of measure, including 'code', 'name', and 'id'.
- **operations** (array) - An array of created operation objects.
- **custom-fields** (object) - Custom fields of the product.
- **parameters** (array) - An array of parameter objects.
- **serializable** (boolean) - Indicates if the product is serializable.

#### Response Example
```json
{
  "code": "P11",
  "name": "Product 11",
  "families": [
    {
      "code": "FG"
    }
  ],
  "color": "#8b0000",
  "observations": "observations",
  "standard-uom": {
    "code": "KG",
    "name": "kg",
    "id": 4
  },
  "operations": [
    {
      "code": "op1",
      "name": "op1",
      "waste": [
        {
          "code": "BROKEN"
        }
      ],
      "task-durations": [
        {
          "validSince": "01/01/2022 - 13:00",
          "validUntil": "01/01/2100 - 13:00",
          "duration": "00H01m00s",
          "duration-customer": "00H01m00s",
          "ratio-quantity": 1
        }
      ],
      "times-per-product": 2,
      "checklists": [
        {
          "code": "CheckIn"
        }
      ],
      "machines": [
        {
          "code": "OVEN02"
        }
      ],
      "disabled": false,
      "optional": false,
      "recovery": false,
      "no-time": false,
      "no-quantity": false,
      "as-team": false,
      "multi-po": false,
      "print-production-barcode": false,
      "prepare-batch-order": false,
      "section": {
        "name": "CUT"
      }
    }
  ],
  "custom-fields": null,
  "parameters": [
    {
      "name": "parameter1",
      "value": "value1"
    },
    {
      "name": "parameter2",
      "value": "2022-12-19T00:00:00Z"
    }
  ],
  "serializable": true
}
```

#### Error Response (400)
##### Body
If there's a problem with the request, the problem found will be reported on the Response Body.

#### Error Response (404)
##### Body
If product with the provided code doesn't exist.
```

--------------------------------

### GET /api/v1/suppliers

Source: https://fusionoperations.autodesk.com/api-documentation

Retrieves a paginated list of suppliers. Requires an access_token with productions_write scope.

```APIDOC
## GET /api/v1/suppliers

### Description
List suppliers. This action requires an access_token with productions_write scope. This service is paginated, returning 25 suppliers per page.

### Method
GET

### Endpoint
/api/v1/suppliers

### Parameters
#### Query Parameters
- **access_token** (string) - Required - Fusion Operations API access token.
- **page** (numeric) - Optional - Result page index, starting in 1.
- **page-size** (numeric) - Optional - Number of results per page, default 25.
- **code** (string) - Optional - List suppliers filtered by code.

### Response
#### Success Response (200)
- **Array** (object) - List of supplier objects

#### Response Example
[
  {
    "id": 987356123,
    "code": "Supplier",
    "name": "Supplier"
  }
]
```

--------------------------------

### Retrieve Production Order Response (200 OK)

Source: https://fusionoperations.autodesk.com/api-documentation

This is an example of a successful response (200 OK) when retrieving a Production Order. It includes details about products, dates, shipping, and status.

```json
{
  "products": [
    {
      "product": "V23076",
      "quantity-ordered": 3500,
      "observations": "",
      "quantity-produced": 700
    }
  ],
  "code": "V23076 - Semana 33/34",
  "custom-fields": [
    {
      "Order Type": "Make to Order"
    }
  ],
  "shipping": {
    "code": "shipping 45"
  },
  "serial-number": "",
  "description": "",
  "start-date": "2016-04-20T09:15:15Z",
  "due-date": "2016-05-16T17:15:15Z",
  "workers-assigned": [
    {
      "number": 120
    },
    {
      "number": 11
    },
    {
      "number": 10
    },
    {
      "number": 1
    }
  ],
  "ended": false,
  "machines": [
    {
      "code": "A32"
    },
    {
      "code": "F1"
    }
  ],
  "pieces-by-box": 20,
  "status": "onschedule",
  "running-status": "started",
  "notes": "",
  "location": {
    "id": "location id",
    "code": "location code",
    "name": "location name"
  },
  "id": 3990
}
```

--------------------------------

### Create Product Family Request Body

Source: https://fusionoperations.autodesk.com/api-documentation

JSON body structure for creating one or more product families.

```json
{
  "product-families": [
    {
      "code": "FAM 1",
      "name": "Family 1"
    },
    {
      "code": "FAM 2",
      "name": "Family 2"
    }
  ]
}
```

--------------------------------

### GET /api/v1/clients

Source: https://fusionoperations.autodesk.com/api-documentation

Retrieves a paginated list of clients. Requires an access_token with productions_write scope.

```APIDOC
## GET /api/v1/clients

### Description
List all clients. This service is paginated, returning 25 results per page.

### Method
GET

### Endpoint
/api/v1/clients

### Parameters
#### Query Parameters
- **access_token** (string) - Required - Fusion Operations API access token.
- **page** (numeric) - Optional - Result page index, starting in 1.
- **page-size** (numeric) - Optional - Number of results per page, default 25.
- **sort** (string) - Optional - Sort results by "id" or "code", default is "id".
- **order** (string) - Optional - Order results by "asc" or "desc", default is "asc".
- **code** (string) - Optional - List Clients filtered by code.

### Response
#### Success Response (200)
- **Array** (object) - List of client objects.

#### Response Example
[
  {
    "id": 987356123,
    "code": "Client",
    "name": "Client"
  }
]
```

--------------------------------

### Example Task Durations Response

Source: https://fusionoperations.autodesk.com/api-documentation

This JSON object shows a paginated list of task durations for a product's operation. It includes item details and pagination information for fetching subsequent results.

```json
{
  "items": [
    {
      "id": 1,
      "validSince": "2021-04-03",
      "cycleTime": "PT3H15M30S",
      "customerTime": "PT2H55M10S",
      "quantityRatio": 1.25
    },
    {
      "id": 2,
      "validSince": "2022-02-10",
      "cycleTime": "PT2H05M25S",
      "customerTime": "PT1H50M00S",
      "quantityRatio": 1.2
    }
  ],
  "pagination": {
    "limit": 2,
    "offset": 0,
    "nextUrl": "https://fusionoperations.autodesk.com/api/v2/products/{productId}/operations/{operationId}/task-durations?limit=2&offset=2"
  }
}
```

--------------------------------

### Machine Counter Request Body

Source: https://fusionoperations.autodesk.com/api-documentation

Example JSON structure for a machine counter update request.

```json
{
  "count": 500,
  "waste": [
    {
      "code": "Waste1",
      "quantity": 20
    }
  ],
  "parameters": [
    {
      "name": "parameter1",
      "value": "value1"
    },
    {
      "name": "parameter2",
      "value": "2022-12-19T00:00:00Z"
    },
    {
      "name": "parameter3",
      "value": 1
    }
  ]
}
```

--------------------------------

### GET /api/v1/punchclocks

Source: https://fusionoperations.autodesk.com/api-documentation

Retrieves a list of punch clock entries. Multiple parameters are treated as an AND condition.

```APIDOC
## GET /api/v1/punchclocks

### Description
To list Punch Clocks. This action requires an access_token with productions_write scope.

### Method
GET

### Endpoint
/api/v1/punchclocks

### Parameters
#### Query Parameters
- **access_token** (string) - Required - Fusion Operations API access token.
- **page** (numeric) - Optional - result page index, starting in 1
- **date-before** (date) - Optional - List punch clock entries with date before this, format YYYY-MM-DDTHH:MM:SSZ
- **date-after** (date) - Optional - List punch clock entries with date after this, format YYYY-MM-DDTHH:MM:SSZ
- **worker** (numeric) - Optional - List punch clock entries for this worker

### Response
#### Success Response (200)
- **id** (numeric) - Punch clock entry ID
- **date** (string) - Date of the entry
- **worker** (object) - Worker details
- **type** (numeric) - 0 ('out') or 1 ('in')

#### Response Example
[
  {
    "id": 372179,
    "date": "2018-09-21T09:24:06.000+01:00",
    "worker": {
      "number": 2
    },
    "type": 1
  }
]
```

--------------------------------

### GET /api/v1/productions

Source: https://fusionoperations.autodesk.com/api-documentation

Retrieves a paginated list of production records based on various filter criteria.

```APIDOC
## GET /api/v1/productions

### Description
List Productions. Multiple parameters will be treated as an AND condition. This action requires an access_token with productions_write scope. This service is paginated, returning 25 productions per page.

### Method
GET

### Endpoint
/api/v1/productions

### Parameters
#### Query Parameters
- **access_token** (string) - Required - Fusion Operations API access token.
- **page** (numeric) - Optional - result page index, starting in 1
- **production-order-id** (numeric) - Optional - List productions with this production-order
- **production-order-code** (string) - Optional - List productions with this (or these) production-order(s)
- **worker** (numeric) - Optional - List productions with this worker (worker number)
- **start-time-before** (date) - Optional - List productions with start time before this
- **start-time-after** (date) - Optional - List productions with start time after this
- **end-time-before** (date) - Optional - List productions with end time before this
- **end-time-after** (date) - Optional - List productions with end time after this
- **start-time** (date) - Optional - List productions which were running after this start-time
- **checked-out** (boolean) - Optional - List productions which are checked out.
- **worker-name** (boolean) - Optional - retrieves the worker name and number instead of just the number of the worker.

### Response
#### Success Response (200)
- **Array** (object) - A list of production objects.

#### Response Example
[
  {
    "production-order": {
      "code": "PO1",
      "id": 36530
    },
    "operation": {
      "code": "2",
      "product": "Product 1",
      "estimated-time": "00:01:00"
    },
    "worker": {
      "number": 2
    },
    "id": 575354
  }
]
```

--------------------------------

### Update a Product File

Source: https://fusionoperations.autodesk.com/api-documentation

Modify the 'show-on-tablet' property of a product file. This action requires an access_token with the 'productions_write' scope and can only update one file per request.

```http
PUT /api/v1/products/{code}/files/{file_id}{?access_token}
```

```http
PUT /api/v1/products/code/files/file_id?access_token=
```

```json
{
  "show-on-tablet": true
}
```

```json
{
  "id": 1,
  "name": "file_name.xlsx",
  "creation-date": "2025-01-25T08:30:01Z",
  "size": 128,
  "show-on-tablet": true
}
```

--------------------------------

### GET /api/v1/production-orders/{id}/files/{file_id}

Source: https://fusionoperations.autodesk.com/api-documentation

Retrieves details for a specific production order file.

```APIDOC
## GET /api/v1/production-orders/{id}/files/{file_id}

### Description
Retrieves metadata for a specific file associated with a production order.

### Method
GET

### Endpoint
/api/v1/production-orders/{id}/files/{file_id}

### Parameters
#### Path Parameters
- **id** (numeric) - Required - Production Order ID.
- **file_id** (numeric) - Required - Production Order File ID.

#### Query Parameters
- **access_token** (string) - Required - Fusion Operations API access token.

### Response
#### Success Response (200)
- **id** (numeric) - File ID
- **name** (string) - File name
- **creation-date** (string) - Creation timestamp
- **size** (numeric) - File size
- **show-on-tablet** (boolean) - Tablet visibility status
```

--------------------------------

### Create Production Order File (JavaScript)

Source: https://fusionoperations.autodesk.com/api-documentation

Upload a file to a production order using JavaScript's XMLHttpRequest. Ensure the file input is correctly referenced.

```javascript
var data = new FormData();
data.append("file", fileInput.files[0], "/path/to/your/file.ext");

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
if(this.readyState === 4) {
  console.log(this.responseText);
}
});

xhr.open("POST", 'https://fusionoperations.autodesk.com/api/v1/production-orders/{id}/files?access_token=xxx');
xhr.send(data);
```

--------------------------------

### Implement Idempotency Logic

Source: https://fusionoperations.autodesk.com/api-documentation

Use the x-prodsmart-webhook-uuid header to deduplicate incoming events and prevent duplicate side-effects.

```text
On receiving a delivery:
  1. Extract `x-prodsmart-webhook-uuid` from headers.
  2. Check whether this UUID has already been processed.
  3. If already processed → return 2xx immediately (no further action).
  4. If not yet processed → process the payload, mark the UUID as processed, then return 2xx.
```
Tokens:
Raw