Pular para o conteúdo
Olist Ecommerce

Cria um carrinho

POST
/api/v2/carts/{id}

Permite criar um carrinho

Authorizations

Seção intitulada “Authorizations ”

Parameters

Seção intitulada “ Parameters ”

Path Parameters

Seção intitulada “Path Parameters ”
id
required
string

Pode ser o id ou o token do carrinho

Header Parameters

Seção intitulada “Header Parameters ”
X-Browser-Ip
required
string format: ipv4

IP do usuário que está criando o carrinho na loja

X-User-Agent
required
string

User-Agent do navegador do usuário criando o carrinho na loja

Request Body

Seção intitulada “Request Body ”
object
agent
string
zip
string
client_id
integer
coupon_code
string
email

DEPRECATED: enviar o client_id

string format: email
rebate_token
string

Responses

Seção intitulada “ Responses ”

201

Seção intitulada “201 ”

Quando um carrinho é criado com sucesso

Cart

Modelo que representa um carrinho na API

object
agent
required
string
nullable
billing_address_id
required
integer
nullable
channel
required
string
nullable
client_id
required
integer
nullable
code
required
string
coupon_code
required
string
nullable
discount
required
object
id
required
integer
name
required
string
description
required
string
nullable
facebook
required
boolean
valid_to
required
string
Allowed values: store cart
seal_uid
required

DEPRECATED

string
seal_url
required

DEPRECATED

string
start_at
required
string format: date-time
end_at
required
string format: date-time
nullable
email
required
string
nullable
cpf
required
string
nullable
tags
required
string
nullable
discount_price
required
number
extra
required
object
id
required
integer
items
required
string
items_count
required
integer
shipping_address_id
required
integer
nullable
shipping_method
required
string
nullable
shipping_methods
required
Array<object>
object
package
required
string
name
required
string
label
required
string
price
required
string
delivery_days
required
string
delivery_type
required
string
description
required
string
short_description
required
string
fulfillment_company
required
string
nullable
shipping_price
required
number
nullable
subtotal
required
number
token
required
string
total
required
number
total_for_deposit
required
number
total_for_slip
required
number
total_for_pix
required
number
updated_at
required
string format: date-time
rebate_token
required
string
nullable
rebate_discount
required
number
handling_days
required
number
subtotal_discount
required
number
total_discount
required
number

422

Seção intitulada “422 ”

Quando os parâmetros enviados são inválidos

422

Modelo que representa um erro de validação na criação e atualização de registros

object
errors
object
{field}
Array<string>
Examples
{
  "errors": {
    "browser_ip": [
      "não pode ficar em branco"
    ],
    "user_agent": [
      "não pode ficar em branco"
    ]
  }
}