Customização Visual + Criação de Módulo Fiscal em Sistema Laravel

Guia de Integração e Customização - Projeto Laravel com Nfe, nfc-e e nfs-e
________________________________________
objetivo:
fornecer um guia passo a passo para um(a) programador(a) realizar a integração de emissão de nfe, nfc-e e nfs-e em um sistema laravel 5.8, além de customizações visuais e melhorias de SEO.
________________________________________
📄 Descrição do Projeto:
Olá, tudo certo?
Estou procurando um(a) desenvolvedor(a) com experiência sólida em Laravel e integração fiscal (NFe/NFC-e) para realizar uma série de melhorias e customizações em um sistema web já funcional.
🤩 Tecnologias envolvidas:
•    Laravel 5.8 (PHP)
•    Banco de Dados MySQL
•    Front-end com html, css, javascript, bootstrap
•    integração via api com nfephp
________________________________________
🎯 escopo do projeto
1. 🌐 Melhorias Front-end
•    Atualização da página inicial com foco em:
o    Otimização para SEO (Google e buscadores)
o    Melhoria na estrutura de código (HTML semântico e limpo)
o    Substituição de logo e imagem de fundo
•    Atualização da página de contato com:
o    Exibição clara dos dados de contato (WhatsApp, e-mail, telefone)
o    Layout moderno e responsivo
•    Melhoria visual no Dashboard principal:
o    Interface mais moderna, limpa e funcional
o    Inclusão de indicadores visuais (notas emitidas, entradas, totais mensais, etc.)
________________________________________
2. 📦 Módulo Fiscal NFe / NFC-e
A) Emissão de Notas:
•    Suporte a emissão via venda ou avulsa
•    Geração automática de XML + pastas mensais
•    Integração com WebService da Sefaz
•    Campos fiscais obrigatórios: ie, cest, cst, ncm, etc.
•    Registro de notas emitidas contra o CNPJ
B) Importação de XML de Compras:
•    Importação automática de XMLs emitidos por fornecedores
•    Armazenamento no banco de dados
•    Vínculo com produtos e fornecedores
C) Manifesto de DF-e:
•    Visualização e confirmação de documentos fiscais eletrônicos
•    Ações: aceitar / recusar / importar
________________________________________
📂 Entregáveis:
•    Sistema atualizado com as alterações visuais e estruturais
•    Módulo fiscal funcional com emissão e importação de nf-e e nfc-e
•    códigos-fonte organizados e comentados
•    instruções para uso e instalação dos novos módulos (manual básico)
________________________________________
🗓️ prazo total estimado: 30 dias úteis
esse prazo inclui:
•    levantamento de requisitos com o cliente
•    desenvolvimento e testes
•    ajustes finais e entrega completa
sugestão de divisão do prazo:
•    10 dias para melhorias visuais (landing page, contato, dashboard)
•    10 dias para módulo fiscal nfe/nfc-e (emissão, importação, manifesto)
•    10 dias para integração de nfs-e
________________________________________
🧑‍💻 requisitos do profissional:
•    experiência comprovada com laravel 5.x
•    Vivência com projetos fiscais e NFePHP
•    Conhecimento em emissão de nfc-e e nfs-e (prefeituras ou apis externas)
•    boa organização, cumprimento de prazos e comunicação clara
________________________________________
parte técnica (completa)
________________________________________
parte 1: melhorias visuais e estruturais
1. Atualização da Página Inicial
•    Tornar a página mais responsiva e com html semântico para seo
•    adicionar título, meta-descrição e palavras-chave
•    atualizar logo (imagem fornecida)
•    atualizar imagem de fundo (padrão moderno)
2. Página de Contato
•    Inserir nome, e-mail, telefone e WhatsApp de forma visível
•    Garantir responsividade e compatibilidade com dispositivos móveis
3. Dashboard
•    Modernizar layout usando Bootstrap 4/5
•    Adicionar cards com indicadores:
o    Total de NFe emitidas
o    Total de NFC-e emitidas
o    Total de entradas por XML
o    Valores totais mensais
________________________________________
Parte 2: Integração com NFePHP (sped-nfe)
1. Instalação do Pacote
composer require nfephp-org/sped-nfe
2. Configuração
Criar arquivo config/nfe.php:
return [
  'cnpj' => 'XXXXXXXXXXXXXX',
  'certificado' => storage_path('app/certs/certificado.pfx'),
  'senha' => env('CERT_PASS'),
  'tpAmb' => 2,
  'estado' => 'SP',
  'versao' => '4.00',
  'modelos' => ['55', '65'],
  'paths' => [
    'xml' => storage_path('app/nfe/xml'),
    'schema' => base_path('vendor/nfephp-org/sped-nfe/src/resources/xml'),
  ],
];
3. Serviço Laravel para Emissão
•    Criar NfeService.php com instância de Tools usando o certificado e dados
•    Montar e assinar XML com dados fiscais
•    Enviar lote com sefazEnviaLote()
•    Consultar recibo com sefazConsultaRecibo()
4. Controller e Rotas
•    Criar NfeController com método emit(Request $request)
•    Rota: Route::post('nfe/emitir', [NfeController::class, 'emit']);
5. Importação de XML
•    Criar job/comando para ler XMLs da pasta storage/xmls/fornecedores
•    Parsear XMLs e salvar no banco
•    Vincular com produtos e fornecedores
6. Manifesto DF-e
•    Usar sefazManifestacao() para confirmação, ciência ou recusa de nota
________________________________________
Parte 3: Emissão de NFC-e
•    Mesmo processo da NFe, alterando modelo para 65
•    Adaptar xml para layout nfc-e
•    utilizar métodos do tools do sped-nfe para emitir nfc-e
________________________________________
parte 4: integração com nfs-e (nota fiscal de serviço eletrônica)
observações:
•    a integração de nfs-e varia conforme a prefeitura (cada cidade tem seu próprio webservice e layout)
•    sugere-se utilizar bibliotecas externas como nfephp/sped-nfse ou apis pagas como tecnospeed ou webmaniabr se for para várias cidades
etapas básicas
1.    Instalar biblioteca:
composer require nfephp-org/sped-nfse
2.    Configurar certificado, cnpj, prefeitura (via json)
3.    Criar métodos para:
•    Enviar RPS (Recibo Provisório de Serviços)
•    Gerar XML e consultar protocolo
•    Consultar status e imprimir nota
4.    Usar o método Tools::enviarLoteRps() para envio
Importante:
•    Testar com WebService de homologação da prefeitura
•    Validar campos obrigatórios (issqn, cnae, regime tributário, etc.)