Criando carrinhos

curl --request POST \
  --url https://lojinha.dev/api/v1/carts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "products": [
    {
      "id": "<string>",
      "quantity": 123
    }
  ]
}'

{
  "cart": {
    "id": "4f24a75c-792a-4aff-9265-19deb198be07",
    "store": "org_2StqHEqEqKtCH66IJjLb73J2ww6",
    "customerId": null,
    "addressId": null,
    "price": 16000,
    "originalPrice": null,
    "status": "PENDING",
    "createdAt": "2023-07-23T22:04:52.234Z",
    "updatedAt": null,
    "deletedAt": null,
    "products": [
      {
        "id": "4cf35a0f-7f25-43ef-8e5e-208fbfeb1bd0",
        "store": "org_2StqHEqEqKtCH66IJjLb73J2ww6",
        "status": "ACTIVE",
        "name": "A Tormenta de Espadas",
        "slug": "a-tormenta-de-espadas",
        "description": "<p>Terceiro livro da série</p>",
        "price": 8000,
        "originalPrice": 12000,
        "quantity": 10,
        "sku": "LI-004",
        "createdAt": "2023-07-22T00:51:44.685Z",
        "updatedAt": "2023-07-23T22:04:32.178Z",
        "deletedAt": null,
        "order": {
          "quantity": 2,
          "price": 16000
        }
      }
    ]
  }
}

POST

carts

Criando carrinhos

curl --request POST \
  --url https://lojinha.dev/api/v1/carts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "products": [
    {
      "id": "<string>",
      "quantity": 123
    }
  ]
}'

{
  "cart": {
    "id": "4f24a75c-792a-4aff-9265-19deb198be07",
    "store": "org_2StqHEqEqKtCH66IJjLb73J2ww6",
    "customerId": null,
    "addressId": null,
    "price": 16000,
    "originalPrice": null,
    "status": "PENDING",
    "createdAt": "2023-07-23T22:04:52.234Z",
    "updatedAt": null,
    "deletedAt": null,
    "products": [
      {
        "id": "4cf35a0f-7f25-43ef-8e5e-208fbfeb1bd0",
        "store": "org_2StqHEqEqKtCH66IJjLb73J2ww6",
        "status": "ACTIVE",
        "name": "A Tormenta de Espadas",
        "slug": "a-tormenta-de-espadas",
        "description": "<p>Terceiro livro da série</p>",
        "price": 8000,
        "originalPrice": 12000,
        "quantity": 10,
        "sku": "LI-004",
        "createdAt": "2023-07-22T00:51:44.685Z",
        "updatedAt": "2023-07-23T22:04:32.178Z",
        "deletedAt": null,
        "order": {
          "quantity": 2,
          "price": 16000
        }
      }
    ]
  }
}

Carrinhos são úteis para que você tenha informações sobre carrinhos ativos e expirados na sua loja, se você não precisa dessas informações, você pode criar um pedido ao invés de um carrinho.

Um produto só adicionado ao carrinho se quantidade disponível for menor ou igual a quantidade requisitada.Caso nenhum produto da lista tenha disponibilidade a API retorna um erro com status 422.

Body

products

array

slug da coleção, retorna a primeira coleção encontrada.

Show child attributes

uuid

required

ID do produto.

quantity

number

required

Quantidade do produto para adicionar no carrinho.

Resposta

cart

object

Show child attributes

uuid

ID do carrinho

store

string

ID da loja

customerId

string | null

ID do cliente

addressId

string | null

ID do endereço do cliente

price

number

Valor do carrinho

originalPrice

number

Valor original do carrinho

status

enum

default:"PENDING"

Status do carrinho. Neste endpoint o valor sempre será PENDING.

createdAt

string | null

Data de criação.

updatedAt

string | null

Data da última modificação

deletedAt

string | null

Data em que foi arquivado.

products

array

Show child attributes

uuid

Id do produto

store

string

ID da loja

status

enum

default:"ACTIVE"

Status do produto, pode ser: DRAFT | ACTIVE

name

string

Nome do produto

slug

string

Slug do produto

description

string | null

Descrição do produto em uma string com HTML

price

number | null

Preço atual do produto

originalPrice

number | null

Preço original do produto

quantity

number | null

Quantidade do produto em estoque

sku

string | null

Código do produto pra controle de estoque Stock Keeping Unit, pode ser o código de barras de um produto único

createdAt

string

Data de criação

updatedAt

string | null

Data da última modifição

deletedAt

string | null

Data em que que foi arquivado

Pela API este dado sempre deve retornar null

order

object

Informações deste produto no carrinho.

Show child attributes

quantity

number

Quantidade deste produto neste carrinho.

price

number

Preço do produto no carrinho.

{
  "cart": {
    "id": "4f24a75c-792a-4aff-9265-19deb198be07",
    "store": "org_2StqHEqEqKtCH66IJjLb73J2ww6",
    "customerId": null,
    "addressId": null,
    "price": 16000,
    "originalPrice": null,
    "status": "PENDING",
    "createdAt": "2023-07-23T22:04:52.234Z",
    "updatedAt": null,
    "deletedAt": null,
    "products": [
      {
        "id": "4cf35a0f-7f25-43ef-8e5e-208fbfeb1bd0",
        "store": "org_2StqHEqEqKtCH66IJjLb73J2ww6",
        "status": "ACTIVE",
        "name": "A Tormenta de Espadas",
        "slug": "a-tormenta-de-espadas",
        "description": "<p>Terceiro livro da série</p>",
        "price": 8000,
        "originalPrice": 12000,
        "quantity": 10,
        "sku": "LI-004",
        "createdAt": "2023-07-22T00:51:44.685Z",
        "updatedAt": "2023-07-23T22:04:32.178Z",
        "deletedAt": null,
        "order": {
          "quantity": 2,
          "price": 16000
        }
      }
    ]
  }
}

Produtos por coleção Recuperando um carrinho

API

​Body

​Resposta

Body

Resposta