enotas/php-client

PHP版本的eNotas GW API客户端

v1.0 2019-01-10 17:53 UTC

This package is auto-updated.

Last update: 2024-09-24 18:23:20 UTC


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仓库克隆到您的机器上,如下所示: 克隆一个Github仓库

或者通过以下命令

$ 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

插入或更新一家公司

上传一家公司的证书

上传一家公司的标志