Carrinho de compras: como funciona a Cart API

A Cart API gerencia o carrinho de compras do cliente antes do início do processo de checkout. Ela é responsável por manter o estado dos produtos selecionados e permitir o agendamento de entrega.

O que é uma sessão de carrinho

Uma sessão de carrinho (cart session) representa o carrinho atual de um cliente. Ela é identificada por um sessionId — um identificador único que sua aplicação define e gerencia. Você pode:

Criar uma nova sessão de carrinho
Atualizar uma sessão existente com novos dados
Consultar o estado atual da sessão
Agendar a sessão para um horário de entrega específico

Endpoints da Cart API

Método	Endpoint	Descrição
`PUT`	`/v1/sessions/{sessionId}`	Criar ou atualizar sessão do carrinho
`GET`	`/v1/sessions/{sessionId}`	Obter dados da sessão do carrinho
`PUT`	`/v1/sessions/{sessionId}/schedule`	Agendar a sessão do carrinho

Criar ou atualizar o carrinho

O endpoint PUT /v1/sessions/{sessionId} é idempotente: se a sessão não existir, ela é criada; se já existir, é atualizada.

curl -X PUT "https://cart-ms.supergasbras.app/v1/sessions/f47ac10b-58cc-4372-a567-0e02b2c3d479" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "c9b1d2e3-f4a5-6789-bcde-f01234567890"
  }'

Agendar entrega

Use o endpoint de agendamento para definir uma data e hora de entrega:

curl -X PUT "https://cart-ms.supergasbras.app/v1/sessions/f47ac10b-58cc-4372-a567-0e02b2c3d479/schedule" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduledDate": "2024-12-20",
    "scheduledTime": "14:00"
  }'

Agende a sessão antes de iniciar o checkout para garantir que o horário de entrega seja validado no momento da compra.

Próximo passo

Após configurar o carrinho, crie uma sessão de compra na Checkout API para dar continuidade ao pedido.

Introdução

Conceitos

Guias

Carrinho de compras: como funciona a Cart API

O que é uma sessão de carrinho

Endpoints da Cart API

Criar ou atualizar o carrinho

Agendar entrega

Próximo passo

​O que é uma sessão de carrinho

​Endpoints da Cart API

​Criar ou atualizar o carrinho

​Agendar entrega

​Próximo passo

O que é uma sessão de carrinho

Endpoints da Cart API

Criar ou atualizar o carrinho

Agendar entrega

Próximo passo