NF-e PHP SDK

Através do emissor de Nota Fiscal da WebmaniaBR®, você conta com a emissão e arquivamento das suas notas fiscais, cálculo automático de impostos, geração do Danfe para impressão e envio automático de e-mails para os clientes. Realize a integração com o seu sistema utilizando a nossa REST API.

• Emissor de Nota Fiscal WebmaniaBR®: Saiba mais
• Documentação REST API: Visualizar

Requisitos

• Contrate um dos planos de Nota Fiscal Eletrônica da WebmaniaBR® a partir de R$29,90/mês: Assine agora mesmo.
• Composer
• Realize a integração com o seu sistema.

Utilização

Instale o módulo da WebmaniaBR® via composer ou baixe nosso repositório e utilize a classe NFe.php que se encontra dentro de src/WebmaniaBR/:

composer require webmaniabr/nfe

Após executar o composer, adicione o require no topo do seu arquivo. Caso tenha baixado manualmente, importe o arquivo NFe.php diretamente na sua aplicação:

require_once __DIR__ . '/vendor/autoload.php';
use WebmaniaBR\NFe;

Caso esteja usando algum framework, como por exemplo o Laravel, instale o módulo da WebmaniaBR® via composer e referencie o seguinte namespace em seu controller:

use WebmaniaBR\NFe;

Dessa forma, a classe NFe já pode ser instanciada e utilizada conforme a sua necessidade! Informe as suas credenciais de acesso diretamente no método construtor da classe NFe:

$this->webmaniabr = new NFe('SEU_CONSUMER_KEY', 'SEU_CONSUMER_SECRET', 'SEU_ACCESS_TOKEN', 'SEU_ACCESS_TOKEN_SECRET');

E pronto, sua plataforma já está pronta para se comunicar com a API da WebmaniaBR®. Para emitir uma NF-e por exemplo, deve ser utilizado o método emissaoNotaFiscal( $data ):

$response = $this->webmaniabr->emissaoNotaFiscal( $data );

if($response->error) {

   echo 'Ocorreu um erro: ' . $resp->error;

}else{

    echo $response->uuid; // Número único de identificação da Nota Fiscal
    echo $response->status; // aprovado, reprovado, cancelado, processamento ou contingencia
    echo $response->nfe; // Número da NF-e
    echo $response->serie; // Número de série
    echo $response->recibo; // Número do recibo
    echo $response->chave; // Número da chave de acesso
    echo $response->xml; // URL do XML
    echo $response->danfe; // URL do Danfe (PDF)
    echo $response->log; // Log do Sefaz

}

Onde $data é um array com os dados da Nota Fiscal a ser emitida, para maiores informações quais dados devem ser enviados, consulte a documentação.

Verifique todos os exemplos de utilização no diretório /exemplos/. Segue abaixo uma listagem dos métodos existentes em nossa SDK e os devidos parâmetros que devem ser informados:

ajusteNotaFiscal( $array ); // Emite uma nota fiscal de ajuste.

cancelarNotaFiscal( $chave, $motivo ); // Cancelar Nota Fiscal enviada ao SEFAZ.

cartaCorrecao(  $chave, $correcao  ); // Corrigir uma Nota Fiscal junto ao SEFAZ.

complementarNotaFiscal( $array ); // Emite uma Nota Fiscal complementar.

consultaNotaFiscal( $chave ); // Consulta o status da Nota Fiscal enviada para o SEFAZ.

devolucaoNotaFiscal( $chave, $natureza_operacao, $ambiente, $codigo_cfop, $classe_imposto, $produtos ); // Emissão de Nota Fiscal de devolução junto ao SEFAZ.

emissaoNotaFiscal( $array ); // Emissão da Nota Fiscal junto ao SEFAZ, com exemplos para a emissão com detalhamento específicos.

inutilizarNumeracao( $sequencia, $motivo, $ambiente ); // Inutilizar sequência de numeração junto ao SEFAZ.

statusSefaz(); // Verifica se o SEFAZ está Online ou Offline.

validadeCertificado(); // Verifica se o Certificado A1 é válido e quantos dias faltam para expirar.

atualizarEmpresa(); // Atualiza os dados da empresa

exportarRelatorios(); // Exporta relatórios de acordo com os parâmetros informados.

Suporte

Qualquer dúvida entre em contato na nossa Central de Ajuda ou acesse o Painel de Controle para conversar em tempo real no Chat ou Abrir um chamado.