---
title: "Incluir item"
url: "https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5/operations/incluir-item"
---

> Full API specification: https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5.md

# Incluir item

`POST` `/orders/{order_id}/items`

Operation ID: `incluir-item`

Quando um pedido está **aberto**, você pode incluir itens nele.

## Path parameters

- `order_id` (string, required) - Código do pedido.

## Request body

Content types: `application/json`

## Responses

- `200` - 200
- `400` - 400

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Pagar.me v5 API (Legado)
  version: 5.0.0
servers:
  - url: https://api.stone.com.br/core/v5
paths:
  /orders/{order_id}/items:
    post:
      summary: Incluir item
      description: Quando um pedido está **aberto**, você pode incluir itens nele.
      operationId: incluir-item
      parameters:
        - name: order_id
          in: path
          description: Código do pedido.
          schema:
            type: string
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - amount
                - description
                - quantity
              properties:
                amount:
                  type: integer
                  description: Valor do item.
                  format: int32
                code:
                  type: string
                  description: "Código do item no sistema da loja. Max: 52 caracteres. Obrigatório
                    para transações de split"
                description:
                  type: string
                  description: "Descrição do item. Max: 256 caracteres."
                quantity:
                  type: string
                  description: Quantidade de itens.
                category:
                  type: string
                  description: "Categoria do item. Max: 64 caracteres."
            examples:
              Request Example:
                value:
                  amount: 1090
                  description: Caneca Zero Grau
                  quantity: 1
                  seller:
                    document: "26224451990"
                    name: Stark Industries
                    code: STRK_01
                    description: Changing the world for a better future.
                    address:
                      line_1: 10880, Malibu Point, Malibu Central
                      zip_code: "90265"
                      city: Malibu
                      state: CA
                      country: US
      responses:
        "200":
          description: "200"
          content:
            application/json:
              examples:
                Result:
                  value: >-
                    {
                      "id": "oi_ZD2lNDKcORty1pzw",
                      "description": "Caneca Zero Grau",
                      "amount": 1090,
                      "quantity": 1,
                      "status": "active",
                      "created_at": "2017-10-05T20:24:38Z",
                      "updated_at": "2017-10-05T20:24:38Z",
                      "order": {
                        "id": "or_oO7vgpeh1rF4DX3A",
                        "code": "7W86TKXIO1",
                        "amount": 5170,
                        "currency": "BRL",
                        "closed": false,
                        "status": "pending",
                        "created_at": "2017-10-05T19:41:29Z",
                        "updated_at": "2017-10-05T19:41:29Z"
                      },
                      "seller": {
                        "id": "sl_jY3D2MziacQnR01W",
                        "name": "Stark Industries",
                        "code": "STRK_01",
                        "document": "26224451990",
                        "description": "Changing the world for a better future.",
                        "status": "active",
                        "created_at": "2017-10-05T20:24:38Z",
                        "updated_at": "2017-10-05T20:24:38Z",
                        "address": {
                          "line_1": "10880, Malibu Point, Malibu Central",
                          "zip_code": "90265",
                          "city": "Malibu",
                          "state": "CA",
                          "country": "US"
                        },
                        "metadata": {}
                      }
                    }
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: oi_ZD2lNDKcORty1pzw
                  description:
                    type: string
                    example: Caneca Zero Grau
                  amount:
                    type: integer
                    example: 1090
                    default: 0
                  quantity:
                    type: integer
                    example: 1
                    default: 0
                  status:
                    type: string
                    example: active
                  created_at:
                    type: string
                    example: 2017-10-05T20:24:38Z
                  updated_at:
                    type: string
                    example: 2017-10-05T20:24:38Z
                  order:
                    type: object
                    properties:
                      id:
                        type: string
                        example: or_oO7vgpeh1rF4DX3A
                      code:
                        type: string
                        example: 7W86TKXIO1
                      amount:
                        type: integer
                        example: 5170
                        default: 0
                      currency:
                        type: string
                        example: BRL
                      closed:
                        type: boolean
                        example: false
                        default: true
                      status:
                        type: string
                        example: pending
                      created_at:
                        type: string
                        example: 2017-10-05T19:41:29Z
                      updated_at:
                        type: string
                        example: 2017-10-05T19:41:29Z
                  seller:
                    type: object
                    properties:
                      id:
                        type: string
                        example: sl_jY3D2MziacQnR01W
                      name:
                        type: string
                        example: Stark Industries
                      code:
                        type: string
                        example: STRK_01
                      document:
                        type: string
                        example: "26224451990"
                      description:
                        type: string
                        example: Changing the world for a better future.
                      status:
                        type: string
                        example: active
                      created_at:
                        type: string
                        example: 2017-10-05T20:24:38Z
                      updated_at:
                        type: string
                        example: 2017-10-05T20:24:38Z
                      address:
                        type: object
                        properties:
                          line_1:
                            type: string
                            example: 10880, Malibu Point, Malibu Central
                          zip_code:
                            type: string
                            example: "90265"
                          city:
                            type: string
                            example: Malibu
                          state:
                            type: string
                            example: CA
                          country:
                            type: string
                            example: US
                      metadata:
                        type: object
                        properties: {}
        "400":
          description: "400"
          content:
            application/json:
              examples:
                Result:
                  value: "{}"
              schema:
                type: object
                properties: {}
      deprecated: false
security:
  - sec0: []
components:
  securitySchemes:
    sec0:
      type: http
      scheme: basic
```