InvoiceTemplate (Template de NF)
O InvoiceTemplate representa um template de configuracao para emissao de notas fiscais.
Descricao
Templates definem as configuracoes padrao para emissao de NF-e e NFC-e, incluindo dados do emitente, certificado digital, series e configuracoes de ambiente.
Dados
Identificacao
| Campo | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
| name | Texto | Sim | Nome do template |
| model | Selecao | Sim | Modelo (55 ou 65) |
| series | Texto | Sim | Serie padrao |
| current_number | Numero | Auto | Ultimo numero usado |
| environment | Selecao | Sim | Ambiente (producao/homologacao) |
| active | Booleano | Sim | Se esta ativo |
Modelos
| Modelo | Descricao | Uso |
|---|---|---|
| 55 | NF-e | Venda para PJ, operacoes diversas |
| 65 | NFC-e | Venda para consumidor final |
Ambientes
| Ambiente | Descricao | Uso |
|---|---|---|
| production | Producao | Notas validas |
| homologation | Homologacao | Testes |
Dados do Emitente
| Campo | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
| emit_cnpj | Texto | Sim | CNPJ |
| emit_ie | Texto | Sim | Inscricao Estadual |
| emit_im | Texto | Nao | Inscricao Municipal |
| emit_name | Texto | Sim | Razao Social |
| emit_trade_name | Texto | Nao | Nome Fantasia |
| emit_crt | Selecao | Sim | Regime tributario |
| emit_cnae | Texto | Nao | CNAE principal |
Endereco do Emitente
| Campo | Tipo | Obrigatorio |
|---|---|---|
| emit_street | Texto | Sim |
| emit_number | Texto | Sim |
| emit_complement | Texto | Nao |
| emit_neighborhood | Texto | Sim |
| emit_city_code | Texto | Sim |
| emit_city | Texto | Sim |
| emit_state | Texto | Sim |
| emit_zip_code | Texto | Sim |
| emit_country_code | Texto | Sim |
| emit_phone | Texto | Nao |
Certificado Digital
| Campo | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
| certificate | Arquivo | Sim | Arquivo .pfx |
| certificate_password | Texto | Sim | Senha do certificado |
| certificate_expires_at | Data | Auto | Validade |
Tipos de Certificado
| Tipo | Descricao |
|---|---|
| A1 | Arquivo (valido 1 ano) |
| A3 | Token/Cartao (valido 3 anos) |
Alerta de Vencimento
Sistema alerta quando certificado esta proximo do vencimento:
- 60 dias antes: alerta amarelo
- 30 dias antes: alerta vermelho
- Vencido: bloqueia emissao
Configuracoes NFC-e
| Campo | Tipo | Descricao |
|---|---|---|
| csc_id | Texto | ID do CSC |
| csc_token | Texto | Token do CSC |
| contingency_enabled | Booleano | Permite contingencia |
| print_width | Selecao | Largura impressao (80mm/58mm) |
CSC (Codigo de Seguranca do Contribuinte)
Obrigatorio para NFC-e:
- Obtido junto a SEFAZ
- Usado para gerar QR Code
Configuracoes NF-e
| Campo | Tipo | Descricao |
|---|---|---|
| danfe_format | Selecao | Formato DANFE (retrato/paisagem) |
| danfe_logo | Imagem | Logo no DANFE |
| print_transport | Booleano | Imprime dados transporte |
| print_issqn | Booleano | Imprime dados ISSQN |
Configuracoes de Email
| Campo | Tipo | Descricao |
|---|---|---|
| send_email | Booleano | Envia automaticamente |
| email_subject | Texto | Assunto do email |
| email_body | Texto | Corpo do email |
| email_copy | Texto | Email para copia |
Variaveis no Email
| Variavel | Substituicao |
|---|---|
{numero} | Numero da NF |
{serie} | Serie |
{emitente} | Nome do emitente |
{destinatario} | Nome do destinatario |
{valor} | Valor total |
Configuracoes de Impressao
| Campo | Tipo | Descricao |
|---|---|---|
| auto_print | Booleano | Imprime automaticamente |
| printer_name | Texto | Nome da impressora |
| copies | Numero | Quantidade de copias |
Relacionamentos
Pertence a
| Entidade | Obrigatorio | Descricao |
|---|---|---|
| Account | Sim | Conta do petshop |
| Store | Sim | Filial |
Usado por
| Entidade | Descricao |
|---|---|
| Invoices | Notas emitidas |
Numeracao
Controle de Sequencia
| Campo | Descricao |
|---|---|
| current_number | Ultimo numero usado |
| next_number | Proximo a usar |
Regras
- Numeracao sequencial por serie
- Nao pode pular numeros
- Numeros pulados devem ser inutilizados
Exemplo
Template: NFC-e Loja Centro
Serie: 1
Ultimo numero: 15.432
Proximo: 15.433
Contingencia
Configuracao
| Campo | Tipo | Descricao |
|---|---|---|
| contingency_enabled | Booleano | Permite contingencia |
| contingency_type | Selecao | Tipo de contingencia |
| contingency_reason | Texto | Motivo padrao |
Ativacao
Contingencia ativada quando:
- SEFAZ indisponivel
- Problemas de rede
- Manualmente pelo usuario
Validacoes
| Campo | Regra |
|---|---|
| emit_cnpj | CNPJ valido |
| emit_ie | IE valida para UF |
| certificate | Arquivo valido |
| certificate_password | Senha correta |
| csc_id | Obrigatorio para NFC-e |
| csc_token | Obrigatorio para NFC-e |
Regras de Negocio
Template por Loja
Cada loja pode ter templates diferentes:
- Certificado proprio
- Series distintas
- Configuracoes especificas
Template Padrao
Um template pode ser marcado como padrao:
- Usado automaticamente nas vendas
- Pode ser alterado por venda
Inativacao
Ao inativar template:
- Novas emissoes bloqueadas
- Consultas ainda permitidas
- Numeracao preservada
Permissoes
| Acao | Descricao |
|---|---|
| Criar | Cadastrar template |
| Editar | Alterar configuracoes |
| Upload certificado | Atualizar certificado |
| Ativar/Inativar | Mudar status |