Visão Geral da API Fiscal
O motor fiscal do Odoo Brasil disponibiliza endpoints e métodos nativos via JSON-RPC e REST para emissão automatizada, consulta de status na SEFAZ, download de XML/DANFE e cancelamento de documentos eletrônicos (NF-e, NFC-e, NFS-e, CT-e e MDF-e).
1. Autenticação
Utilize chaves de API nativas do Odoo (menu Preferências → Segurança da Conta → Chaves de API) enviadas no cabeçalho Authorization: Bearer <API_KEY> ou via autenticação padrão JSON-RPC.
2. Principais Métodos no Modelo l10n_br_fiscal.document
action_document_confirm(): Valida todos os campos fiscais (NCM, CFOP, CST, IBS/CBS, ICMS, PIS/COFINS) e trava o documento para transmissão.action_document_send(): Assina digitalmente o XML com o Certificado A1 e transmite de forma síncrona/assíncrona para a SEFAZ ou Prefeitura.action_document_cancel(justificativa): Envia o evento de cancelamento oficial (mínimo de 15 caracteres de justificativa).action_document_cce(texto_correcao): Registra e transmite Carta de Correção Eletrônica (CC-e) vinculada à chave de acesso.
3. Consulta da Base de Conhecimento Fiscal para Agentes de IA
Agentes externos também podem consultar nossa base de conhecimento fiscal diretamente pelo endpoint JSON:
GET /docs/api/knowledge-base.json?q=NF-e&category=nf-e&limit=20