README

本客户端是用 PHP 编写的 eNotas Gateway API 客户端，用于自动开具服务（NFS-e）、产品（NF-e）和消费者（NFC-e）电子发票的平台。

注意：此库应用于开具 NFS-e（服务发票），如果您想开具 NF-e（产品发票）或 NFC-e（消费者发票），请使用 php-client-v2 库

文档

以下提供 eNotas Gateway 的官方文档供查阅

此外，我们也很重视您理解开具发票的一般流程，因此请阅读以下文档

开具发票的一般流程

安装 eNotas GW PHP 客户端

要手动安装此库，只需将 Git 仓库克隆到您的机器上，如下所示：

或者通过以下命令：

$ git clone https://github.com/eNotasGW/php-client

要通过 composer 安装，请使用以下命令：

composer require enotas/php-client

使用我们的客户端非常简单，请看

下载这里提供的文件后，只需将文件复制到您的应用程序目录中，并引用 eNotasGW.php 类即可。此外，您还需要以下两个信息

以下是一个开具发票的简单示例

<?php
	header('Content-Type: text/html; charset=utf-8');	
	
	require('../src/eNotasGW.php');
	
	eNotasGW::configure(array(
		'apiKey' => '<sua api key>'
	));
	
	$idEmpresa = '484FB0C5-969E-46AD-A047-8A0DB54667B4';

	eNotasGW::$NFeApi->emitir($idEmpresa, array(
		'tipo' => 'NFS-e',
		'idExterno' => '5', //id para mapeamento com sistema de origem (opcional)
		'ambienteEmissao' => 'Homologacao', //'Homologacao' ou 'Producao'
		'cliente' => array(
			'nome' => 'Nome Cliente',
			'email' => 'cliente@mail.com',
			'cpfCnpj' => '23857396237',
			'tipoPessoa' => 'F',
			'endereco' => array(
				'uf' => 'MG', 
				'cidade' => 'Belo Horizonte',
				'logradouro' => 'Rua 01',
				'numero' => '112',
				'bairro' => 'Savassi',
				'cep' => '32323111'
			)
		),
		'servico' => array(
			'descricao' => 'Discriminação do serviço prestado'
		),
		'valorTotal' => 10.05
	));
?>

需要更多示例？没问题！ ;)

所有示例都可以在 "samples" 文件夹中找到

点击这里进入示例文件夹

或者如果您愿意，您可以直接进入您需要的文件，我们还为每个项目提供了官方文档

下载已开具的发票

下载已开具发票的 XML

示例文件
- 下载已开具发票的 XML
文档
- 了解使用内部 ID 下载 XML 发票的字段信息
- 了解使用外部 ID 下载 XML 发票的字段信息

插入或更新企业

插入或更新企业
- 了解插入/更新企业的字段信息

上传公司证书

示例文件
- 发送公司证书
文档
- 了解更多关于绑定公司证书的字段信息

上传公司Logo

示例文件
- 发送公司Logo
文档
- 了解更多关于绑定公司Logo的字段信息

artemidas / enotas-php-client

维护者

详细信息