ZEXTENDRA) é o ecossistema central de integração fiscal da Extendra nativo para ambientes SAP ECC e S/4HANA. Ele orquestra a comunicação bidirecional com o orquestrador n8n, aplica lógicas tributárias complexas (Reforma Tributária IBS/CBS) e monitora ativamente as operações de documentos fiscais (NF-e, NFS-e, CC-e, Inutilização).
O pacote utiliza um modelo de comunicação moderno onde o SAP atua como o iniciador (Master) enviando payloads estruturados em JSON para as rotas webhook do orquestrador n8n (Worker), que se encarrega do roteamento para as diversas prefeituras e SEFAZ.
A estrutura orientada a objetos do ZEXTENDRA foi desenhada para promover o reuso, encapsulamento de rotinas HTTP e a padronização das chamadas.
ZCL_EXTENDRA_DFE (Fachada Principal)A classe central (Motor Fiscal) por onde todas as emissões e lógicas de negócio transitam.
PROCESS_DFE: Ponto de entrada padrão. Constrói o XML base e decide a rota.BUILD_IBS_CBS_TAGS: Implementa a Reforma Tributária. Inspeciona a tabela ZEX_CLSTRIB. Se TIPO_ALIQ = 'S', gera apenas CST e cClassTrib, evitando cálculos de valores.PROCESSAR_RESPONSE_NFSE: Faz o parsing do JSON retornado pelo n8n. Recupera o array erros[] do payload para alimentar precisos CSTAT e XMOTIVO na tabela de controle.PRINT_DFE: Orquestra a extração do DANFSE/PDF disparando a rota /nfse-sap-consulta.Cada classe herda lógicas padronizadas para acionar uma ação específica no motor:
ZCL_INT_OB_SEND_APROVAR_DFE: Submissão e Autorização de Documentos.ZCL_INT_OB_SEND_CANCELAR_DFE: Cancelamento de NF-e/NFS-e.ZCL_INT_OB_SEND_CONSULTAR_DFE: Consulta de Status / Download de XML/PDF.ZCL_INT_OB_SEND_CCE_DFE: Emissão de Carta de Correção.ZCL_INT_OB_SEND_INUT_DFE / ZCL_INT_OB_SEND_CONS_INUT_DFE: Inutilização de Numeração.Para eliminar URLs hardcoded e permitir transporte transparente entre DEV/QAS/PRD:
ZEX_CFG_HOST: Define o Hostname ativo (Ex: https://dev-extendran8n.saphana.dev).ZEX_CFG_URL / ZEX_CFG_API / ZEX_CFG_MET: Define os endpoints e métodos específicos por tipo de operação.ZEX_CLSTRIB: Classes de Tributação.ZEX_CST_IBS, ZEX_ALIQ_IBS: Cadastros de Códigos de Situação Tributária e Alíquotas para os novos impostos.ZEX_CLS_IS, ZEX_CRED_PRES: Imposto Seletivo e Crédito Presumido.ZEX_T_DFE_INT: A tabela principal de estado da integração (Armazena UUID, Status, CSTAT, XML de Envio/Retorno).ZEX_LOG_DFE / ZEX_T_DFE_EVT: Histórico detalhado de Eventos e rastreabilidade de comunicação.A suíte de aplicações abrange desde manutenção até diagnósticos severos:
| Programa / Transação | Descrição | Casos de Uso |
|---|---|---|
ZEX_REL_DFE |
Relatório ALV Fiscal de Monitoramento | Visão Key User. Oculta dados técnicos, exibe status das notas e permite baixar PDF/XML através de botões na toolbar. |
ZEX_SIMULADOR_NFSE |
Simulador Ponta a Ponta | Testes Standalone. Sobe um XML local (cl_ixml), altera tp_amb = 2 e força a submissão via ZCL_EXTENDRA_DFE sem ferir tabelas Standard. |
ZEX_COCKPIT_TRIB |
Cockpit de Configuração Tributária | Tela unificada para cadastro das regras da Reforma Tributária. |
ZEX_SQL_UPDATE |
Suporte ADBC / Filtros J_1BNFE | Correção massiva via UI na J_1BNFE_ACTIVE ou inserção de Open SQL Native para destravar integrações presas. |
[!CAUTION]
A utilização da funcionalidade Native SQL noZEX_SQL_UPDATEquebra as travas lógicas do SAP (ENQUEUE) e realiza modificações diretas no banco de dados HANA. Recomenda-se apenas para perfil de administrador do sistema ou Firefighters.
A demonstração abaixo exibe a harmonia entre o ABAP, a estrutura de roteamento dinâmico e o Middleware N8N durante uma consulta.