Extensão de Devoluções

br.dev.bcp.shopping.returns estende order e declara política de devolução no perfil empresarial.

Visão geral

Esta extensão abrange os retornos do comércio à distância brasileiro em duas partes:

• Política no perfil de descoberta: prazo de retirada e canal de solicitação, para que o consumidor possa ver os direitos de devolução antes da finalização da compra.
• Registro de devolução no pedido: BCP já modela alterações pós-venda como pedido adjustments[]; esta extensão adiciona motivo de devolução, prazos legais e campos de logística reversa.

O período de retirada de sete dias começa na entrega confirmada, representada pelo evento de cumprimento delivered existente.

Descoberta```json

{ "capabilities": { "br.dev.bcp.shopping.returns": [ { "version": "2026-07-14", "extends": "br.dev.bcp.shopping.order", "spec": "https://bcp.dev.br/2026-07-14/specification/returns", "schema": "https://bcp.dev.br/2026-07-14/schemas/shopping/returns.json", "config": { "withdrawal_period_days": 7, "request_channel": "https://loja.example.com.br/devolucoes" } } ] } } ```## Composição do esquema

• As entradas order.adjustments[] são estendidas para dados específicos de retorno.
• A configuração da política é definida por schemas/shopping/types/returns_config.json.
• Esquema: schemas/shopping/returns.json.

Campos

Política config

Campo	Tipo	Obrigatório	Descrição
withdrawal_period_days	inteiro	Não	Prazo de retirada em dias corridos, mínimo 7, contados da entrega confirmada.
request_channel	corda	Não	Canal utilizado para solicitar devoluções; deve incluir o canal de compra.

Campos de ajuste de retorno

Campo	Tipo	Obrigatório	Descrição
reason	corda aberta	Não	Valores sugeridos: withdrawal, defect, wrong_product.
acknowledged_at	data-hora	Não	Quando o vendedor reconheceu o pedido.
reverse_shipping_code	corda	Não	Código de envio/postagem reverso.
carrier	corda	Não	Transportadora cuidando do fluxo reverso.
deadline	data-hora	Não	Prazo para o consumidor devolver o produto.

Normas Normativas

1. O direito de retirada DEVE ser divulgado antes da conclusão; política config é a fonte do protocolo para essa divulgação.
2. As transações BCP são transações de comércio à distância; regras de retirada se aplicam a todas as transações, a menos que uma extensão futura tenha escopo diferente.
3. O vendedor DEVE reconhecer os pedidos de devolução dentro dos prazos legalmente exigidos período aplicável à transação.
4. Os reembolsos de saque DEVERÃO ser integrais, incluindo frete pago, representado por ajustes de retorno negativo e totais.

Exemplo

Trecho da resposta do pedido:json { "id": "ord_789", "fulfillment": { "events": [ { "id": "ev_9", "type": "delivered", "occurred_at": "2026-07-01T16:20:00-03:00", "line_items": [{ "id": "li_1", "quantity": 1 }] } ] }, "adjustments": [ { "id": "adj_1", "type": "return", "status": "pending", "occurred_at": "2026-07-03T10:00:00-03:00", "reason": "withdrawal", "acknowledged_at": "2026-07-04T09:00:00-03:00", "reverse_shipping_code": "BR123456789XX", "carrier": "Correios", "deadline": "2026-07-13T23:59:59-03:00", "line_items": [{ "id": "li_1", "quantity": -1 }] } ] }