=== CloudXM NFe ===
Contributors: cloudxm
Tags: woocommerce, nfe, nota fiscal, invoice, brazil, fiscal
Requires at least: 5.9
Tested up to: 6.4
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Emissão de NFe via CloudXM para WooCommerce

== Description ==

O CloudXM NFe é um plugin para WooCommerce que permite a emissão automática de Notas Fiscais Eletrônicas (NFe) através da API CloudXM.

= Principais Recursos =

* Emissão automática de NFe ao completar pedidos
* Integração completa com a API CloudXM NFe
* Download de PDF e XML das notas fiscais
* Cancelamento de NFe dentro do prazo legal
* Interface administrativa intuitiva
* Suporte a ambientes de homologação e produção
* Mapeamento automático de dados do pedido para NFe
* Log detalhado para troubleshooting

= Recursos Administrativos =

* Página de configuração completa
* Tabela de serviços com todas as NFe emitidas
* Meta box no pedido para ações rápidas
* Sincronização com a API CloudXM
* Estatísticas de emissão

= Integração WooCommerce =

* Observação automática de pedidos
* Mapeamento de cliente e serviços
* Suporte a CPF e CNPJ
* Suporte a endereço completo
* Integração com métodos de pagamento

== Installation ==

1. Faça o upload do plugin para a pasta `/wp-content/plugins/`
2. Ative o plugin através do menu "Plugins" no WordPress
3. Configure as credenciais da API em Configurações > CloudXM NFe
4. Ative a emissão automática se desejado

== Configuration ==

1. Acesse Configurações > CloudXM NFe
2. Configure a URL base da API
3. Insira os tokens de API para ambientes de homologação e produção
4. Selecione o ambiente desejado (homologação ou produção)
5. Configure o limite de dias para cancelamento
6. Ative ou desative a emissão automática

== Usage ==

= Emissão Automática =

Com a emissão automática ativada, as NFe serão emitidas automaticamente quando o pedido for concluído.

= Emissão Manual =

1. Acesse o pedido desejado
2. No meta box "CloudXM NFe", clique em "Emitir NFe"
3. A NFe será gerada e os dados serão salvos no pedido

= Download de Documentos =

1. Acesse o pedido desejado
2. No meta box "CloudXM NFe", clique em "Download PDF" ou "Download XML"
3. Ou acesse CloudXM NFe > NFe Services na administração

= Cancelamento =

1. Acesse o pedido desejado
2. No meta box "CloudXM NFe", clique em "Cancelar NFe"
3. Informe o motivo do cancelamento
4. A NFe será cancelada se estiver dentro do prazo legal

== Changelog ==

= 2.14.0 =
* Fix: auto-issuance uses get_address instead of get_billing_address for CPF/CNPJ fields
* Add: data-testid attributes to metabox templates for locale-agnostic E2E testing
* Add: id attribute to settings submit button for reliable test targeting
* Fix: test infrastructure — HPOS navigation, WP_PREFIX support, PT-BR locale

= 1.0.0 =
* Lançamento inicial do plugin
* Emissão automática de NFe
* Integração com API CloudXM
* Download de PDF e XML
* Cancelamento de NFe
* Interface administrativa completa

== Frequently Asked Questions ==

= O plugin funciona com qualquer tema? =
Sim, o plugin é compatível com qualquer tema WordPress/WooCommerce.

= Preciso de alguma extensão adicional? =
Não, o plugin funciona de forma independente. Apenas o WooCommerce é obrigatório.

= O plugin funciona com gateways de pagamento específicos? =
Sim, o plugin funciona com qualquer gateway de pagamento do WooCommerce.

= Como faço backup das NFe emitidas? =
As NFe são salvas como meta dados do pedido. Faça backup do banco de dados WordPress regularmente.

= O plugin suporta homologação? =
Sim, o plugin suporta ambientes de homologação e produção separados.

== Screenshots ==

1. Página de configurações
2. Tabela de serviços
3. Meta box no pedido

== Upgrade Notice ==

= 1.0.0 =
Versão inicial do plugin.

== Other Notes ==

= Requisitos =

* WordPress 5.9 ou superior
* WooCommerce 5.0 ou superior
* PHP 7.2 ou superior

= Suporte =

Para suporte, acesse: https://cloudxm.com.br/support

= Documentação =

Para documentação completa, acesse: https://cloudxm.com.br/docs/nfe

== A brief Markdown Example ==

`[cloudxm_nfe_invoice_id]` - ID da fatura na API CloudXM
`[cloudxm_nfe_access_key]` - Chave de acesso da NFe
`[cloudxm_nfe_number]` - Número da NFe
`[cloudxm_nfe_status]` - Status da NFe (draft, issued, processing, cancelled, failed)
`[cloudxm_nfe_issuance_date]` - Data de emissão da NFe

== Arbitrary section ==

Este plugin segue os padrões de desenvolvimento WordPress e WooCommerce.

== Credits ==

Desenvolvido por CloudXM

== License ==

Este plugin é licenciado sob GPLv2 ou posterior.

Copyright 2024 CloudXM

Este programa é software livre; você pode redistribuí-lo e/ou modificá-lo sob os termos da Licença Pública Geral GNU conforme publicada pela Free Software Foundation; tanto a versão 2 da Licença, ou (a seu critério) qualquer versão posterior.

Este programa é distribuído na esperança de que seja útil, mas SEM QUALQUER GARANTIA; sem mesmo a garantia implícita de COMERCIABILIDADE ou ADEQUAÇÃO A UM PROPÓSITO PARTICULAR. Veja a Licença Pública Geral GNU para mais detalhes.

Você deve ter recebido uma cópia da Licença Pública Geral GNU junto com este programa; se não, escreva para a Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
