Introdução
O Erro JSONRPC do Odoo ocorre quando uma solicitação enviada ao Odoo usando o protocolo JSON-RPC falha. JSON-RPC é a principal camada de comunicação utilizada pelo cliente web do Odoo e muitas integrações modernas.
Ao contrário do XML-RPC, o JSON-RPC é amplamente utilizado em:
- Interações de frontend web
- Integrações personalizadas
- Implementações Odoo headless
- Sincronizações de sistemas externos
Quando algo corre mal durante uma chamada JSON-RPC, o Odoo retorna uma resposta de erro que frequentemente aparece como:
ERRO_RPC: Erro do Servidor Odoo
Ou em respostas da API como um objeto de erro JSON.
Este guia explica o que significam os erros JSONRPC no Odoo e como corrigi-los adequadamente.
O que é JSON-RPC no Odoo?
JSON-RPC (Chamada de Procedimento Remoto em Notação de Objetos JavaScript) permite que os clientes chamem métodos do Odoo via HTTP utilizando cargas JSON.
Um pedido típico de JSON-RPC parece com isto:
{
"jsonrpc": "2.0",
"method": "call",
"params": {
"service": "object",
"method": "execute_kw",
"args": [
"nome_do_banco_de_dados",
2,
"senha",
"res.partner",
"search",
[[["is_company", "=", true]]]
]
},
"id": 1
}
Se o backend encontrar uma exceção, o Odoo retorna uma resposta de erro JSON.
Causas Comuns de Erros JSONRPC no Odoo
1. Falha na Autenticação
Se o pedido usar:
- Credenciais inválidas
- Base de dados errada
- Sessão expirada
Odoo rejeita a chamada.
Problemas de autenticação são uma das falhas mais frequentes do JSONRPC.
2. Chamada de Método Inválida
Se o payload JSON referenciar:
- Um modelo inexistente
- Um método inexistente
- Argumentos de método incorretos
O backend gera uma exceção retornada como um erro JSONRPC.
3. Campos Requeridos Faltando
Se uma chamada de criação ou escrita omitir campos obrigatórios, o Odoo gera um erro de validação que aparece na resposta JSON.
Exemplo:
{
"name": "Pedido 001"
}
Se partner_id for obrigatório → erro.
4. Restrições de Direitos de Acesso
Se o utilizador da API não tiver permissão para a ação solicitada, o Odoo retorna um erro relacionado com o acesso em formato JSON.
Isto ocorre frequentemente em produção quando os utilizadores de integração têm permissões limitadas.
5. IDs Relacionais Inválidos
Se um campo Many2one receber um ID que não existe, o backend gera uma exceção.
Exemplo:
{
"partner_id": 99999
}
Se o ID 99999 não existir → erro JSONRPC.
6. Violações de Restrições de Base de Dados
Erros como:
- Valor da chave duplicada viola a restrição de unicidade
- Falha na restrição de chave estrangeira
- Restrição de não nulo
Pode aparecer nas respostas JSONRPC.
7. Tempo de Espera do Servidor ou Operação Pesada
Carga útil grande ou operações em massa podem exceder os limites de tempo de espera, especialmente em integrações de alto volume.
Como Corrigir Erros JSONRPC no Odoo
Passo 1 – Inspecionar a Resposta de Erro JSON
A maioria das respostas JSONRPC inclui:
- Tipo de erro
- Mensagem de erro
- Rastreamento
Leia atentamente os detalhes da exceção do backend.
Passo 2 – Verificar Autenticação
Assegure-se:
- O nome da base de dados está correto
- O ID do utilizador ou o token de sessão é válido
- A palavra-passe ou a chave da API está correta
- O utilizador está ativo
Passo 3 – Validar Estrutura do Payload
Antes de enviar pedidos:
- Confirme que os campos obrigatórios estão incluídos
- Valide os IDs relacionais
- Evite valores nulos em campos obrigatórios
- Assegure-se de que os tipos de dados estão corretos
A validação estruturada antes de enviar dados previne muitas falhas em tempo de execução.
Passo 4 – Rever Direitos de Acesso
Verifique se o utilizador de integração tem:
- Acesso de leitura
- Acesso de escrita
- Acesso de criação
- Acesso de eliminação
dependendo da ação.
Passo 5 – Testar na UI do Odoo
Reproduza a mesma ação manualmente no Odoo.
Se falhar na UI, o problema está provavelmente relacionado com dados ou permissões.
Passo 6 – Verificar Registos do Servidor
Se a resposta JSON for genérica, inspecione os logs do servidor Odoo para detalhes completos do traceback.
Como Prevenir Erros JSONRPC
- Use utilizadores de API dedicados
- Valide os dados antes de enviar
- Registre os payloads de solicitação/resposta
- Implemente um tratamento de erro estruturado na sua integração
- Evite enviar operações em massa em uma única solicitação
- Teste fluxos de integração em staging
Em ambientes Odoo orientados por API, implementar uma camada de validação e transformação entre sistemas externos e Odoo reduz significativamente as falhas JSONRPC.
Como a Dasolo Fortalece a Comunicação JSONRPC
Os erros JSONRPC frequentemente decorrem de um manuseio de sessão inconsistente, estruturas de solicitação malformadas ou lógica do lado do servidor não validada. Como o JSONRPC alimenta a maioria das interações web no Odoo, até mesmo pequenas lacunas de configuração podem levar a falhas recorrentes na interface.
Na Dasolo, reforçamos a estabilidade do JSONRPC através de:
- Validação estruturada de solicitações
- Gerenciamento controlado de sessões
- Padrões claros de tratamento de exceções
- Exposição segura de endpoints
- Registro abrangente de chamadas de API
Uma estrutura de comunicação consistente reduz erros de tempo de execução inesperados e melhora a confiabilidade geral da plataforma.
Conclusão
O erro "JSONRPC Error" do Odoo geralmente aparece quando uma exceção no backend interrompe a comunicação entre o cliente e o servidor. Embora o erro possa parecer genérico, geralmente reflete problemas mais profundos na formatação de solicitações, autenticação ou lógica do lado do servidor.
Ao revisar cuidadosamente as estruturas de API, validar entradas e implementar um tratamento de erros previsível, os desenvolvedores podem prevenir interrupções recorrentes do JSONRPC. Uma camada de comunicação bem projetada garante interação estável e eficiente dentro dos ambientes Odoo.