Executando

Correção e finalização de sistema emissor de Nf-e (Python/Docker)

Publicado em 21 de Março de 2026 dias na TI e Programação

Sobre este projeto

Aberto

Estamos buscando um freelancer experiente para corrigir e finalizar um sistema emissor de NF-e que está em desenvolvimento. O sistema roda em uma VPS própria (Ubuntu/Docker) e já está funcional em sua maior parte, incluindo frontend em React, backend em Python (FastAPI), banco de dados PostgreSQL, certificado digital A1 configurado, assinatura xml implementada e comunicação soap com a sefaz estabelecida.O problema principal é que a SEFAZ retorna o erro cStat 225 - "Falha no Schema XML do lote de NFe". Isso indica que o xml gerado, embora bem-formado e digitalmente assinado, não está 100% aderente ao schema xsd oficial (layout 4.00). Algum campo pode estar fora do padrão exigido, seja na ordem das tags, ausência de um campo obrigatório ou formato incorreto.

As tarefas a serem realizadas incluem:

Validar o XML gerado contra os XSDs oficiais da SEFAZ para identificar todos os erros de schema.
Corrigir o arquivo xml_builder.py e quaisquer outras partes relevantes do código até que a nota fiscal seja autorizada com sucesso em ambiente de homologação.
Garantir que o fluxo completo de emissão de NF-e funcione perfeitamente, incluindo a emissão, consulta de status e cancelamento.

A stack tecnológica utilizada é:

Backend: Python 3 / FastAPI
Frontend: React (já funcional, não requer alterações)
Banco de dados: PostgreSQL
Infraestrutura: Docker Compose em vps (acesso ssh root será fornecido)
certificado: a1 (.pfx) já configurado

O que já está pronto e não precisa de intervenção:

Envelope soap montado e configurado para envio ao webservice correto da sefaz.
Assinatura digital do XML utilizando certificado A1.
Estrutura completa do xml da nf-e (ide, emit, dest, det, total, transp, pag, infadic).
Frontend com funcionalidades de cadastro de produtos, clientes e interface de emissão.

Requisitos essenciais para o freelancer:

Experiência com emissão de NF-e via código, preferencialmente sem o uso de bibliotecas prontas como PyNFe, para garantir um entendimento profundo do processo.
Conhecimento aprofundado do layout 4.00 da nf-e e dos schemas xsd da sefaz.
Familiaridade com Docker e experiência em acesso e gerenciamento via SSH.

A entrega esperada é um sistema totalmente funcional, capaz de emitir nf-e com sucesso em ambiente de homologação, com todas as validações de schema xml corrigidas.

Categoria TI e Programação
Subcategoria Programação
Qual é o alcance do projeto? Alteração média

Prazo de Entrega: Não estabelecido

Habilidades necessárias

Outro projetos publicados por T. C. C.