# Disputas

Disputas são um **mecanismo explícito, conduzido por humanos** no Offer Hub.

Elas existem para lidar com casos em que:

* a entrega é contestada,
* a aprovação é retida,
* o cancelamento é solicitado,
* ou evidências devem ser revisadas.

Offer Hub **não** depende de timeouts ou arbitragem automatizada.\
Em vez disso, as disputas são resolvidas pelo **plataforma do marketplace**, atuando como suporte ao cliente, com resultados aplicados por contratos de escrow.

***

### Objetivo

Permitir:

* **compradores ou vendedores** abrirem uma disputa,
* **a plataforma** revisar evidências e decidir o resultado,
* **o escrow** aplicar a resolução final (liberação ou reembolso).

***

### Atores

* **Comprador**
* **Vendedor**
* **UI do OfferHub**
* **Backend do OfferHub (Orquestrador)**
* **Trustless Work Escrow**
* **Trustless Work dApp (Backoffice)**
* **Endereço do Resolvedor de Disputas (controlado pela plataforma)**

***

### Quando uma Disputa Pode Ser Aberta

Uma disputa pode ser iniciada **a qualquer momento após o escrow ser financiado e antes da liberação final**.

Cenários típicos incluem:

#### Disputas Iniciadas pelo Comprador

* O produto nunca chegou
* O serviço não foi entregue conforme acordado
* As evidências de entrega são insuficientes
* O vendedor marcou a entrega prematuramente

#### Disputas Iniciadas pelo Vendedor

* O comprador está sem resposta
* O comprador se recusa a aprovar apesar da entrega
* O vendedor quer cancelar e reembolsar
* O vendedor tem fortes evidências de cumprimento

Ambas as partes têm o direito de **sinalizar a transação**, mas nenhuma delas pode resolvê-la por conta própria.

***

### Iniciação da Disputa

#### 1. Comprador ou Vendedor Abre uma Disputa

```
Usuário → UI do OfferHub: Abrir Disputa
```

Esta ação:

* é iniciada off-chain,
* registra a intenção de contestar,
* ainda não movimenta fundos.

OfferHub captura:

* quem abriu a disputa
* código do motivo
* evidências opcionais (mensagens, arquivos, links)

***

#### 2. O Escrow É Marcado como Disputado

```
OfferHub → Trustless Work:
  Marcar escrow como Disputado
```

Uma vez disputado:

* o escrow é congelado,
* nenhuma liberação ou reembolso pode ocorrer automaticamente,
* o controle passa para o **papel de Resolvedor de Disputas**.

O status do pedido é atualizado para **Disputado**.

***

### Resolução pela Plataforma (Fluxo de Backoffice)

#### Decisão de Design Importante

> **O Offer Hub não implementa seu próprio backoffice de disputas.**

Em vez disso, ele aproveita o **dApp Trustless Work existente**, que já suporta:

* inspeção de escrow,
* assinatura baseada em papéis,
* execução de liberação e reembolso.

Isso evita duplicação e garante comportamento consistente.

***

#### 3. A Plataforma Faz Login no dApp Trustless Work

Um operador da plataforma (suporte ao cliente) faz login no dApp Trustless Work usando o **endereço do Resolvedor de Disputas / Assinante de Liberação** atribuído ao escrow.

📌 Referência:

* Trustless Work dApp (Backoffice)
* Faça login usando a carteira do resolvedor configurada para o marketplace

***

#### 4. A Plataforma Analisa o Caso

Usando:

* evidências fornecidas pelo OfferHub (off-chain)
* estado on-chain do escrow
* histórico de transações

A plataforma decide um dos seguintes resultados:

* **Liberar fundos para o vendedor**
* **Reembolsar fundos ao comprador**

***

#### 5. A Plataforma Assina a Resolução

```
Trustless Work dApp → Escrow:
  Executar Liberação OU Reembolso
```

Esta ação:

* é assinado pelo endereço do resolvedor/assinante de liberação da plataforma,
* é aplicado on-chain,
* é final.

***

### Estado Pós-Resolução

Após a resolução:

* O escrow passa para **Liberado** ou **Reembolsado**
* O pedido passa para **Fechado**
* Os fundos são transferidos de acordo
* Existe um trilho de auditoria completo (on-chain + off-chain)

***

### Resultados

* ✅ Disputa registrada
* ✅ Escrow congelado durante a revisão
* ✅ Resolução aplicada on-chain
* ✅ Pedido fechado com resultado final

***

### O que os Usuários Veem

#### Comprador

* Atualizações de status da disputa
* Resultado final (reembolso ou não)
* Explicação clara da plataforma

#### Vendedor

* Atualizações de status da disputa
* Resultado final (pago ou reembolsado)
* Explicação da decisão da plataforma

***

### Modelo de Segurança e Confiança

* Compradores **não podem** liberar fundos
* Vendedores **não podem** liberar fundos
* Plataforma **podem apenas agir dentro das regras do escrow**
* Todas as ações de resolução são assinadas e auditáveis

***

### Notas Educacionais

#### Por Que Ambas as Partes Podem Abrir Disputas

Isto reflete marketplaces reais:

* disputas são sinais, não decisões,
* abrir uma disputa não implica má conduta,
* a resolução é tratada pelo suporte ao cliente.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.trustlesswork.com/trustless-work/v1-pt/dapps-oss/offerhub-marketplace/fluxos-principais/disputas.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.