Referência da API · Carrinho Personalizado

Editar Carrinho Personalizado

Método: PUT
Rota: /customCart/edit
URL base: https://ws.autorei.net
Token: Exige token Bearer

Abre esta requisição na documentação pública da API, a fonte oficial da referência.

Descrição

Aplica novos itens a um carrinho já criado, sem gerar outro link: o cartId e a URL continuam os mesmos.

Corpo da Requisição (JSON)

Campo	Tipo	Obrigatório	Descrição
`cartId`	integer	Sim	Id do carrinho, como veio em `cartId` na criação.
`updateType`	string	Não	`complement` soma as quantidades aos itens que já estão no carrinho; `replacement` descarta os itens antigos e deixa só os enviados. Sempre em minúsculas. Omitido, cada item enviado entra como uma linha nova.
`document`	string	Sim	CPF ou CNPJ do cliente do carrinho.
`products`	array	Sim	Itens a aplicar.
`cartName` · `sellerEmail` · `cartTypeName` · `cartTypeExternalId` · `metadata`	-	Não	Mesmos campos da criação.

Dentro de cada item de products:

Campo	Tipo	Obrigatório	Descrição
`stockId`	integer	Sim	Id do estoque do produto na sua loja. É a identificação aceita pelo carrinho.
`quantity`	integer	Sim	Quantidade do produto.
`virtualQuantity`	integer	Não	Quantidade em estoque virtual.
`warehouse`	integer	Não	Id do depósito de origem do item.
`storeExternalId`	string	Não	Id externo da loja do item.
`skuId`	integer	Não	Id do SKU.
`partnerPartCode`	string	Não	Seu código de produto.
`key`	string	Não	Chave própria do item.

Regras de negócio

Os dois valores de `updateType`

complement procura o item pelo stockId e soma a quantidade enviada à que já estava lá; os metadados novos são juntados aos antigos. replacement apaga os itens que estavam no carrinho e grava só os que você enviou; os metadados também são substituídos.

Os valores são comparados exatamente, em minúsculas. Qualquer outro texto não entra em nenhum dos dois caminhos: o item enviado vira uma linha nova no carrinho e os antigos continuam lá.

Resposta · 200

Mesma estrutura da criação, status, message com a URL e cartId. O cartId e a URL são os do carrinho que você alterou, não de um novo.

Erros

Código	Quando
400	A alteração não foi aplicada. A mensagem vem do serviço de carrinho.
401	Token ausente, malformado ou expirado.

Exemplo de requisição

curl --request PUT 'https://ws.autorei.net/customCart/edit' \
  --header 'Authorization: Bearer {{access_token}}' \
  --header 'Content-Type: application/json' \
  --data '{
  "cartId": 4470001,
  "updateType": "complement",
  "document": "700.413.648-56",
  "products": [
    {
      "stockId": 4410002,
      "quantity": 5
    }
  ]
}'

Respostas de exemplo

200Sucesso: itens aplicados ao carrinho

{
  "status": "ok",
  "message": "https://lojaexemplo.cws.digital/carrinho-personalizado/k7m2p9x4t1c6b8v3n5q0w7z2y4d6f8h1",
  "cartId": 4470001
}

Usado em

Casos de usoPortal B2B próprio: o caminho típico pela API
Casos de usoCompras B2B e suprimentos: o caminho típico pela API
Casos de usoVenda assistida e balcão: o caminho típico pela API

Endpoints relacionados

POST Criar Carrinho Personalizado /customCart/create
DELETE Deletar Carrinho Personalizado por ID /customCart/deleteById/:id

← Ver o grupo: Carrinho Personalizado

Gerado a partir da coleção pública da API, publicada em 04/09/2026: api-docs.cws.digital.