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
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.
Agendar entrega
Use o endpoint de agendamento para definir uma data e hora de entrega:
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. 
