# Printful

> Browse Printful products and stores, estimate shipping and costs, and create, update or cancel unconfirmed draft orders.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/printful

## Actions

### Cancel draft order

Cancel draft order.

**Inputs**

- Draft order (`order_id`, text, required): Draft order.
- Store (`store_id`, number): Store. At least 1.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "result": {
      "id": 1,
      "items": [],
      "recipient": {
        "name": "example"
      },
      "status": "example"
    }
  }
}
```

### Create draft order

Create draft order.

**Inputs**

- Store (`store_id`, number): Store. At least 1.
- Recipient name (`recipient_name`, text, required): Recipient name.
- Street address (`address1`, text, required): Street address.
- Apartment or suite (`address2`, text): Apartment or suite.
- City (`city`, text, required): City.
- Country (`country_code`, text, required): Country.
- State or province (`state_code`, text): State or province code.
- Postal code (`zip`, text, required): Postal code.
- Recipient email (`email`, text): Recipient email.
- Items (`items`, list, required): Each item needs a quantity and either a store sync_variant_id or a catalog variant_id with print files.
- External id (`external_id`, text): External id.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "result": {
      "id": 1,
      "items": [],
      "recipient": {
        "name": "example"
      },
      "status": "example"
    }
  }
}
```

### Estimate order costs

Estimate order costs.

**Inputs**

- Store (`store_id`, number): Store. At least 1.
- Recipient name (`recipient_name`, text, required): Recipient name.
- Street address (`address1`, text, required): Street address.
- Apartment or suite (`address2`, text): Apartment or suite.
- City (`city`, text, required): City.
- Country (`country_code`, text, required): Country.
- State or province (`state_code`, text): State or province code.
- Postal code (`zip`, text, required): Postal code.
- Recipient email (`email`, text): Recipient email.
- Items (`items`, list, required): Each item needs a quantity and either a store sync_variant_id or a catalog variant_id with print files.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "result": {
      "costs": {
        "currency": "example",
        "total": "example"
      }
    }
  }
}
```

### Get catalog product

Get catalog product.

**Inputs**

- Catalog product (`product_id`, text, required): Catalog product.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "paging": {
      "limit": 1,
      "offset": 1,
      "total": 1
    },
    "result": {
      "product": {
        "id": 1
      },
      "variants": []
    }
  }
}
```

### Get catalog variant

Get catalog variant.

**Inputs**

- Variant id (`variant_id`, text, required): Variant id.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "paging": {
      "limit": 1,
      "offset": 1,
      "total": 1
    },
    "result": {}
  }
}
```

### Get file

Get file.

**Inputs**

- File id (`file_id`, text, required): File id.
- Store (`store_id`, number): Store. At least 1.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "paging": {
      "limit": 1,
      "offset": 1,
      "total": 1
    },
    "result": {}
  }
}
```

### Get order

Get order.

**Inputs**

- Order (`order_id`, text, required): Order.
- Store (`store_id`, number): Store. At least 1.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "paging": {
      "limit": 1,
      "offset": 1,
      "total": 1
    },
    "result": {
      "id": 1,
      "items": [],
      "recipient": {
        "address1": "example",
        "address2": "example",
        "city": "example",
        "country_code": "example",
        "email": "example",
        "name": "example",
        "state_code": "example",
        "zip": "example"
      },
      "status": "example"
    }
  }
}
```

### Get shipping rates

Get shipping rates.

**Inputs**

- Store (`store_id`, number): Store. At least 1.
- Recipient name (`recipient_name`, text, required): Recipient name.
- Street address (`address1`, text, required): Street address.
- Apartment or suite (`address2`, text): Apartment or suite.
- City (`city`, text, required): City.
- Country (`country_code`, text, required): Country.
- State or province (`state_code`, text): State or province code.
- Postal code (`zip`, text, required): Postal code.
- Recipient email (`email`, text): Recipient email.
- Items (`items`, list, required): Each item needs a quantity and either a store sync_variant_id or a catalog variant_id with print files.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "result": []
  }
}
```

### Get store

Get store.

**Inputs**

- Store (`store_id`, text, required): Store id.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "paging": {
      "limit": 1,
      "offset": 1,
      "total": 1
    },
    "result": {}
  }
}
```

### Get store product

Get store product.

**Inputs**

- Store product (`sync_product_id`, text, required): Store product.
- Store (`store_id`, number): Store. At least 1.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "paging": {
      "limit": 1,
      "offset": 1,
      "total": 1
    },
    "result": {
      "sync_product": {
        "id": 1
      },
      "sync_variants": []
    }
  }
}
```

### Get store variant

Get store variant.

**Inputs**

- Variant id (`variant_id`, text, required): Variant id.
- Store (`store_id`, number): Store. At least 1.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "paging": {
      "limit": 1,
      "offset": 1,
      "total": 1
    },
    "result": {
      "files": [],
      "id": 1,
      "variant_id": 1
    }
  }
}
```

### Get warehouse product

Get warehouse product.

**Inputs**

- Warehouse product id (`warehouse_product_id`, text, required): Warehouse product id.
- Store (`store_id`, number): Store. At least 1.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "paging": {
      "limit": 1,
      "offset": 1,
      "total": 1
    },
    "result": {}
  }
}
```

### List catalog products

List catalog products.

**Inputs**: None.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "paging": {
      "limit": 1,
      "offset": 1,
      "total": 1
    },
    "result": []
  }
}
```

### List countries

List countries.

**Inputs**: None.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "paging": {
      "limit": 1,
      "offset": 1,
      "total": 1
    },
    "result": []
  }
}
```

### List orders

List orders.

**Inputs**

- Store (`store_id`, number): Store. At least 1.
- Status (`status`, text): Status. One of: `draft`, `pending`, `failed`, `canceled`, `inprocess`, `onhold`, `partial`, `fulfilled`, `archived`.
- Limit (`limit`, number): Limit. From 1 to 100.
- Offset (`offset`, number): Offset. At least 0.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "paging": {
      "limit": 1,
      "offset": 1,
      "total": 1
    },
    "result": []
  }
}
```

### List store products

List store products.

**Inputs**

- Store (`store_id`, number): Store. At least 1.
- Limit (`limit`, number): Limit. From 1 to 100.
- Offset (`offset`, number): Offset. At least 0.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "paging": {
      "limit": 1,
      "offset": 1,
      "total": 1
    },
    "result": []
  }
}
```

### List stores

List stores.

**Inputs**: None.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "paging": {
      "limit": 1,
      "offset": 1,
      "total": 1
    },
    "result": []
  }
}
```

### List tax countries

List tax countries.

**Inputs**: None.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "paging": {
      "limit": 1,
      "offset": 1,
      "total": 1
    },
    "result": []
  }
}
```

### List warehouse products

List warehouse products.

**Inputs**

- Store (`store_id`, number): Store. At least 1.
- Limit (`limit`, number): Limit. From 1 to 100.
- Offset (`offset`, number): Offset. At least 0.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "paging": {
      "limit": 1,
      "offset": 1,
      "total": 1
    },
    "result": []
  }
}
```

### Update draft order

Update draft order.

**Inputs**

- Draft order (`order_id`, text, required): Draft order.
- Store (`store_id`, number): Store. At least 1.
- Recipient name (`recipient_name`, text): Recipient name.
- Street address (`address1`, text): Street address.
- Apartment or suite (`address2`, text): Apartment or suite.
- City (`city`, text): City.
- Country (`country_code`, text): Country.
- State or province (`state_code`, text): State or province code.
- Postal code (`zip`, text): Postal code.
- Recipient email (`email`, text): Recipient email.
- Items (`items`, list): Each item needs a quantity and either a store sync_variant_id or a catalog variant_id with print files.

**Outputs**

- `data` (object): The service response, including pagination metadata when present.

**Example output**

```json
{
  "data": {
    "code": 1,
    "result": {
      "id": 1,
      "items": [],
      "recipient": {
        "name": "example"
      },
      "status": "example"
    }
  }
}
```
