# Guia de informações e Suporte - Nova API Conta Azul

### 🎯 Objetivo

Centralizar informações e esclarecer dúvidas sobre:

- A **nova API Conta Azul** e seus recursos;
- O processo de **descontinuação da API legada**;
- Os **procedimentos de suporte e atendimento**;
- As **principais dúvidas técnicas e processuais** mapeadas até o momento.


## 1. Contexto Geral

A Conta Azul está evoluindo seu ecossistema de integrações para oferecer uma API muito mais completa e aderente às necessidades financeiras dos negócios.

| Versão | Escopo | Indicação |
|  --- | --- | --- |
| **API Atual (Legada)** | Integra produtos, serviços, clientes, fornecedores e vendas. Não cobre módulo Financeiro. | Ideal para sincronização básica de cadastros e vendas. |
| **Nova API (Completa)** | Integra cadastros, vendas e **todo o módulo Financeiro**, incluindo contas a pagar/receber, conciliações, cobranças, contratos e centros de custo. | Ideal para automação ponta a ponta — da venda ao fechamento contábil e fiscal. |


## 2. Canais de Atendimento e Suporte

### 📩 Canal principal

- **E-mail:** [api@contaazul.com](mailto:api@contaazul.com)
- **Tempo de resposta:** até **24 horas úteis**


### 🧾 Informações obrigatórias para o atendimento

Para acelerar o suporte, inclua:

1. **client_id** (para validação da credencial);
2. **Informações técnicas completas**:
  - Payload
  - Headers
  - Body
  - Status code
  - Comando CURL
  - Endpoint utilizado
3. **Prints de tela** ou **exemplos de erro**.


## 3.  FAQ – Dúvidas Técnicas e Processuais

### Sobre a migração da API Legada

details
summary
strong
1. A API legada será descontinuada?
Sim.
A nova API substituirá completamente a antiga, oferecendo maior cobertura e estabilidade.

details
summary
strong
2. Existe prazo para migração?

 Novembro de 2025 a API Legada será desativada

details
summary
strong
3. Meu app precisa de adequações?
Sim — endpoints, autenticação e payloads foram atualizados. Recomenda-se revisar o mapeamento atual antes de migrar. Consulte as nossas documentações aqui dispostas.

details
summary
strong
4. Como migrar dados da API antiga para a nova?
Não existe uma migração de dados, apenas o  mapeamento de transformação deve ser feito no tratamento entre a nova API e a base do integrador. Existe uma paridade de informações com a principal diferença, sendo que as respostas da API nova tem campos em PT-BR (Português - Brasil)

details
summary
strong
6. Recebi comunicação sobre desativação da v1. O que fazer?
Acesse nossa documentação da API Pública, nela você encontrará toda orientação para nova API. Caso tenha dúvida, entre em contato com o nosso time de suporte técnico pelo e-mail:
`api@contaazul.com`

## 🔍 Diferenças funcionais entre as versões

| Área | API Legada | Nova API |
|  --- | --- | --- |
| Produtos/Serviços | ✅ | ✅ |
| Clientes/Fornecedores | ✅ | ✅ + Transportadoras |
| Vendas | ✅ | ✅ + Orçamentos + Ordens de Serviço |
| Financeiro | ❌ | ✅ Contas a pagar/receber, conciliações, cobranças |
| Notas Fiscais | ❌ | ✅ Consulta de NF de produto |
| Contratos/Centros de Custo | ❌ | ✅ Gestão completa |
| Categorias e Lançamentos | ❌ | ✅ Inclusos |


## 📚 Recursos e Documentações

- Para qualquer dúvida, problema ou necessidade de assistência durante a migração ou o desenvolvimento com a nova API, entre em contato com nosso time pelo e-mail **api@contaazul.com**
.
Nosso time oferecerá suporte e garantirá que você tenha todo o apoio necessário durante o processo.


Além disso, você também pode acessar o nosso **Chat** pelo Portal do Desenvolvedor para tirar dúvidas e obter orientações sobre o uso das APIs.