=== Emitare NFS-e para WooCommerce ===
Contributors: emitare
Tags: nfse, nota fiscal, nota fiscal servico, woocommerce, fiscal, brasil, prefeitura, erp
Requires at least: 5.8
Tested up to: 6.6
Requires PHP: 7.4
Stable tag: 1.0.0
WC requires at least: 7.0
WC tested up to: 8.9
License: MIT
License URI: https://opensource.org/licenses/MIT

Emite NFS-e automaticamente quando um pedido WooCommerce é completado. Gateway multi-prefeitura para todos os 5.570 municípios do Brasil.

== Description ==

O **Emitare NFS-e para WooCommerce** conecta sua loja virtual à [API NFS-e Emitare](https://emitare.com.br) e emite Notas Fiscais de Serviço Eletrônicas (NFS-e) automaticamente quando um pedido é concluído.

= Por que usar o Emitare? =

* **Cobertura nacional** — suporte a todos os 5.570 municípios do Brasil
* **10 provedores integrados** — Ginfes, Issnet, Sigiss, Betha, IPM, SimplISS, DSF, eGoverne, Prodam (São Paulo) e Padrão Nacional (LC 214/2025)
* **Zero manutenção de webservices** — a Emitare cuida das integrações com cada prefeitura
* **NFS-e ou erro, nunca bloqueio** — falhas de emissão adicionam nota interna no pedido sem impedir a conclusão
* **DANFSe em PDF** — link direto no painel do pedido

= Funcionalidades =

* Emissão automática ao status "Completo" do pedido
* Botão "Emitir / Reemitir" no painel do pedido
* Configuração de discriminação com placeholders `{produto}` e `{pedido}`
* Log de emissões em WooCommerce > Emitare NFS-e
* Botão "Testar conexão" para validar a API Key antes de ir para produção
* Compatível com HPOS (High-Performance Order Storage) do WooCommerce
* API Key salva criptografada no banco (AES-256-CBC)
* Suporte a ambiente sandbox para testes

= Provedores Suportados =

| Provedor    | Protocolo          | Municípios |
|-------------|--------------------|-----------|
| Ginfes      | SOAP/ABRASF 2.x    | ~1.200    |
| Issnet      | SOAP/ABRASF 2.04   | ~800      |
| Sigiss      | SOAP proprietário  | ~500      |
| Betha       | SOAP/ABRASF 2.02   | ~400      |
| IPM         | REST/XML           | ~350      |
| SimplISS    | SOAP/ABRASF        | ~300      |
| eGoverne    | SOAP/ABRASF 2.02   | ~200      |
| DSF         | SOAP proprietário  | ~50       |
| Prodam      | SOAP proprietário  | São Paulo |
| Nacional    | REST/ADN 2026      | Todos     |

== Installation ==

= Instalação automática =

1. Acesse **Plugins > Adicionar Novo** no painel WordPress
2. Procure por "Emitare NFS-e"
3. Clique em **Instalar** e depois **Ativar**

= Instalação manual =

1. Baixe o arquivo ZIP do plugin
2. Acesse **Plugins > Adicionar Novo > Enviar Plugin**
3. Selecione o ZIP e clique em **Instalar**
4. Clique em **Ativar Plugin**

= Configuração =

1. Acesse **WooCommerce > Emitare NFS-e**
2. Informe sua **API Key** (obtenha em [emitare.com.br/dashboard](https://emitare.com.br/dashboard))
3. Informe o **Company ID** (UUID da sua empresa cadastrada no Emitare)
4. Configure o **Código do Serviço** conforme a LC 116/2003 e sua prefeitura
5. Personalize a **Discriminação do Serviço** com os placeholders `{produto}` e `{pedido}`
6. Clique em **Testar Conexão** para confirmar que tudo está funcionando
7. Salve e ative — a partir de agora, pedidos completados disparam emissão automática

== Frequently Asked Questions ==

= O plugin funciona para qualquer município do Brasil? =

Sim! A API Emitare suporta os 5.570 municípios brasileiros por meio de 10 integrações diferentes com os sistemas de NFS-e das prefeituras.

= O que acontece se a emissão falhar? =

O pedido é concluído normalmente. Uma nota interna é adicionada ao pedido com o erro, e você pode tentar emitir novamente pelo botão "Reemitir" no painel do pedido.

= Preciso de um certificado digital? =

Sim, para prefeituras que exigem assinatura digital. Você faz o upload do certificado A1 (.pfx) no painel Emitare — o plugin não precisa gerenciar o certificado diretamente.

= O plugin é compatível com HPOS (High-Performance Order Storage)? =

Sim, o plugin declara compatibilidade com a funcionalidade de tabelas de pedidos customizadas do WooCommerce (HPOS/COT).

= Como funciona a discriminação com placeholders? =

No campo "Discriminação do Serviço", você pode usar `{produto}` (substituído pelo nome do primeiro produto do pedido) e `{pedido}` (substituído pelo ID do pedido). Exemplo: `Desenvolvimento web — Pedido #{pedido}` vira `Desenvolvimento web — Pedido #1042`.

= Posso usar o plugin em modo de testes? =

Sim! Marque a opção **Ambiente Sandbox** nas configurações. Neste modo, as notas são processadas no ambiente de homologação Emitare e não são transmitidas à prefeitura.

= Onde vejo o log de emissões? =

Em **WooCommerce > Emitare NFS-e**, no final da página. O log guarda as últimas 200 emissões com data, número do pedido, status e mensagem de erro (se houver).

= A API Key fica salva de forma segura? =

Sim. A API Key é criptografada com AES-256-CBC usando as chaves internas do WordPress (`AUTH_KEY` + `SECURE_AUTH_KEY`) antes de ser salva no banco.

= Qual o código do serviço devo usar? =

Depende da sua atividade. Consulte a tabela da LC 116/2003 ou peça orientação ao seu contador. Exemplos comuns:
- 1.07 — Suporte técnico em informática
- 1.01 — Análise e desenvolvimento de sistemas
- 17.06 — Propaganda e publicidade

== Screenshots ==

1. Página de configurações em WooCommerce > Emitare NFS-e
2. Meta box no pedido com status da NFS-e e botão de reemissão
3. Log de emissões com status, número da nota e mensagens de erro

== Changelog ==

= 1.0.0 =
* Lançamento inicial
* Emissão automática ao completar pedido WooCommerce
* Suporte a 10 provedores de NFS-e (5.570 municípios)
* Página de configurações em WooCommerce > Emitare NFS-e
* Meta box no pedido com status, número e link para DANFSe
* Log de emissões com últimas 200 entradas
* Compatibilidade com HPOS (High-Performance Order Storage)
* API Key salva criptografada (AES-256-CBC)
* Botão "Testar conexão" com feedback imediato
* Botão "Reemitir" para reprocessar em caso de falha
* Suporte a ambiente sandbox

== Upgrade Notice ==

= 1.0.0 =
Versão inicial. Instale e configure sua API Key para começar a emitir NFS-e automaticamente.

== Sobre a Emitare ==

A [Emitare](https://emitare.com.br) é uma plataforma de emissão de NFS-e que cobre todos os 5.570 municípios do Brasil. Nossa API REST elimina a necessidade de integrar com dezenas de webservices diferentes das prefeituras — você envia um JSON padronizado e a Emitare cuida do resto.

Documentação completa: [emitare.com.br/docs](https://emitare.com.br/docs)
Suporte: suporte@emitare.com.br
