---
updatedAt: 2026-09-01T13:50:42.000Z
agentTools:
  projectIndex: https://docs.asaas.com/llms.txt
---

# Status local divergente do Asaas

Esse erro ocorre quando o sistema da integração mantém um status diferente do registrado no Asaas.

A divergência pode ser causada por falha no processamento de eventos, atualização incorreta, processamento fora de ordem ou ausência de uma rotina de reconciliação.

### Como identificar

* o status local não corresponde ao status atual no Asaas;
* uma cobrança paga, cancelada ou estornada permanece desatualizada no sistema;
* não existe histórico da última atualização;
* ações são executadas com base em informações antigas;
* o status permanece inalterado por mais tempo que o esperado;
* divergências são identificadas e corrigidas apenas manualmente.

### Como corrigir

1. Identifique a entidade pelo ID do Asaas ou pelo identificador interno.
2. Consulte o status atual diretamente no Asaas.
3. Compare o status, o horário e a origem das atualizações.
4. Confirme qual informação deve prevalecer.
5. Corrija o status local.
6. Registre a correção, a origem e o horário da atualização.
7. Localize o evento relacionado à mudança.
8. Revise o processamento e a ordem dos eventos.
9. Implemente ou ajuste a rotina de reconciliação.

**Fluxo recomendado:** identificar a entidade → consultar o status atual → comparar os registros → corrigir a divergência → investigar a causa → reconciliar.

### Fluxo de diagnóstico

#### 1. Confirmação e correção da divergência

```mermaid
%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7
}}}%%
flowchart TD
    A["O status local não corresponde ao Asaas"] --> B{"O status atual foi consultado no Asaas?"}

    B --> BSim(("Sim"))
    B --> BNao(("Não"))
    B --> BDuvida(("Não sabe"))

    BNao --> C["Consultar a entidade pelo ID do Asaas"]
    BDuvida --> C

    C --> D{"Os status realmente divergem?"}
    BSim --> D

    D --> DSim(("Sim"))
    D --> DNao(("Não"))

    DSim --> E["Definir o status correto da operação"]
    DNao --> F["Verificar ID, cache e origem da informação"]

    E --> G["Corrigir o status local"]
    F --> H["Corrigir a origem do status exibido"]

    G --> I["Registrar a correção, a origem e o horário"]
    H --> I

    I --> J["Status validado e correção registrada"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
    classDef decisao fill:#FEF3C7,stroke:#D97706,color:#78350F,stroke-width:3px
    classDef correcao fill:#FFEDD5,stroke:#EA580C,color:#7C2D12,stroke-width:2px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px
    classDef analise fill:#FEE2E2,stroke:#DC2626,color:#7F1D1D,stroke-width:3px

    classDef respostaSim fill:#22C55E,stroke:#15803D,color:#FFFFFF,stroke-width:3px
    classDef respostaNao fill:#EF4444,stroke:#B91C1C,color:#FFFFFF,stroke-width:3px
    classDef respostaDuvida fill:#8B5CF6,stroke:#6D28D9,color:#FFFFFF,stroke-width:3px

    class A inicio
    class B,D decisao
    class G,H correcao
    class C,E,I validacao
    class J sucesso
    class F analise

    class BSim,DSim respostaSim
    class BNao,DNao respostaNao
    class BDuvida respostaDuvida

    linkStyle default stroke:#94A3B8,stroke-width:2px

    linkStyle 1,8 stroke:#22C55E,stroke-width:4px
    linkStyle 2,9 stroke:#EF4444,stroke-width:4px
    linkStyle 3 stroke:#8B5CF6,stroke-width:4px
```

<br />

#### 2. Identificação da causa e reconciliação

```mermaid
%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7
}}}%%
flowchart TD
    A["A divergência foi corrigida"] --> B{"O evento correspondente foi recebido e processado?"}

    B --> BSim(("Sim"))
    B --> BNao(("Não"))
    B --> BDuvida(("Não sabe"))

    BNao --> C["Revisar entrega, persistência e processamento do evento"]

    BDuvida --> D["Consultar logs e histórico de eventos"]
    D --> C

    C --> E["Corrigir a causa e testar novamente"]

    BSim --> F{"O status foi atualizado pelo evento mais recente?"}
    E --> F

    F --> FSim(("Sim"))
    F --> FNao(("Não"))
    F --> FDuvida(("Não sabe"))

    FNao --> G["Revisar mapeamento, ordem e idempotência"]

    FDuvida --> H["Comparar horário e origem das atualizações"]
    H --> G

    FSim --> I{"Existe rotina de reconciliação?"}
    G --> I

    I --> ISim(("Sim"))
    I --> INao(("Não"))

    INao --> J["Implementar reconciliação de status"]

    ISim --> K{"A rotina identifica operações divergentes?"}
    J --> K

    K --> KSim(("Sim"))
    K --> KNao(("Não"))

    KSim --> L["Manter correção automática e alertas"]
    KNao --> M["Ajustar critérios, frequência e monitoramento"]
    M --> L

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
    classDef decisao fill:#FEF3C7,stroke:#D97706,color:#78350F,stroke-width:3px
    classDef correcao fill:#FFEDD5,stroke:#EA580C,color:#7C2D12,stroke-width:2px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px
    classDef analise fill:#FEE2E2,stroke:#DC2626,color:#7F1D1D,stroke-width:3px

    classDef respostaSim fill:#22C55E,stroke:#15803D,color:#FFFFFF,stroke-width:3px
    classDef respostaNao fill:#EF4444,stroke:#B91C1C,color:#FFFFFF,stroke-width:3px
    classDef respostaDuvida fill:#8B5CF6,stroke:#6D28D9,color:#FFFFFF,stroke-width:3px

    class A inicio
    class B,F,I,K decisao
    class E,G,J,M correcao
    class D,H validacao
    class L sucesso
    class C analise

    class BSim,FSim,ISim,KSim respostaSim
    class BNao,FNao,INao,KNao respostaNao
    class BDuvida,FDuvida respostaDuvida

    linkStyle default stroke:#94A3B8,stroke-width:2px

    linkStyle 1,10,18,23 stroke:#22C55E,stroke-width:4px
    linkStyle 2,11,19,24 stroke:#EF4444,stroke-width:4px
    linkStyle 3,12 stroke:#8B5CF6,stroke-width:4px
```

<br />

> O primeiro fluxo orienta **como confirmar e corrigir a divergência**, enquanto o segundo identifica **por que o status deixou de ser atualizado e como evitar novas inconsistências**.

<br />

### Como prevenir

Processe e persista os eventos de mudança de status, registre a origem e o horário de cada atualização e mantenha uma rotina de reconciliação para operações pendentes ou inconsistentes.

Antes de executar ações críticas, confirme se o sistema está utilizando o estado mais recente da operação.

> **O status local deve acompanhar o ciclo de vida da operação no Asaas, não apenas a resposta inicial da API.**

<br />

# Sibling pages

* [Webhook recebido, mas não persistido](https://docs.asaas.com/docs/webhook-recebido-mas-não-persistido.md)
* [Webhook com timeout ou resposta demorada](https://docs.asaas.com/docs/webhook-não-processado-dentro-do-tempo-esperado.md)
* [API Key usada no ambiente errado](https://docs.asaas.com/docs/api-key-de-sandbox-usada-em-produção.md)
* [Sistema dependente apenas da resposta síncrona](https://docs.asaas.com/docs/sistema-dependente-apenas-da-resposta-síncrona.md)
* [Cobrança duplicada após retry sem idempotência](https://docs.asaas.com/docs/cobrança-duplicada-após-retry-sem-idempotência.md)
* [Entidade criada sem vínculo com o registro interno](https://docs.asaas.com/docs/entidade-criada-sem-vínculo-com-o-registro-interno.md)
* [Requisições bloqueadas por ausência de controle de limites](https://docs.asaas.com/docs/requisições-bloqueadas-por-ausência-de-controle-de-limites.md)
* [Listagem incompleta por ausência de paginação](https://docs.asaas.com/docs/listagem-incompleta-por-ausência-de-paginação.md)
* [Webhook duplicado processado sem idempotência](https://docs.asaas.com/docs/webhook-duplicado-processado-sem-idempotência.md)