PHP Класс NFePHP\NFe\ToolsNFe

Наследование: extends NFePHP\Common\Base\BaseTools
Показать файл Открыть проект Примеры использования класса

Открытые свойства

Свойство Тип Описание
$errors string errrors
$soapDebug string soapDebug

Защищенные свойства (Protected)

Свойство Тип Описание
$urlPortal string urlPortal Instância do WebService

Открытые методы

Метод Описание
addB2B ( string $pathNFefile = '', string $pathB2Bfile = '', string $tagB2B = '' ) : string addB2B Adiciona tags de comunicação B2B, especialmente ANFAVEA
addCancelamento ( string $pathNFefile = '', string $pathCancfile = '', boolean $saveFile = false ) : string addCancelamento Adiciona a tga de cancelamento a uma NFe já autorizada NOTA: não é requisito da SEFAZ, mas auxilia na identificação das NFe que foram canceladas
addProtocolo ( string $pathNFefile = '', string $pathProtfile = '', boolean $saveFile = false ) : string addProtocolo Adiciona o protocolo de autorização de uso da NFe NOTA: exigência da SEFAZ, a nota somente é válida com o seu respectivo protocolo
assina ( string $xml = '', boolean $saveFile = false ) : string assina Assina uma NFe
ativaContingencia ( string $siglaUF = '', string $motivo = '', string $tipo = '' ) : boolean ativaContingencia Ativa a contingencia SVCAN ou SVCRS conforme a sigla do estado ou EPEC
desativaContingencia ( ) : boolean desativaContingencia Desliga opção de contingência
enviaMail ( string $pathXml = '', array $aMails = [], string $templateFile = '', boolean $comPdf = false, string $pathPdf = '' ) : boolean enviaMail Envia a NFe por email aos destinatários Caso $aMails esteja vazio serão obtidos os email do destinatário e os emails que estiverem registrados nos campos obsCont do xml
getImpostosIBPT ( string $ncm = '', string $exTarif = '0', string $siglaUF = '' ) : array getImpostosIBPT Consulta o serviço do IBPT para obter os impostos ao consumidor conforme Lei 12.741/2012
getLastMsg ( )
getModelo ( ) : string getModelo Retorna o modelo de NFe atualmente setado
getSalvarMensagensEvento ( )
getTimestampCert ( ) : integer getTimestampCert Retorna o timestamp para a data de vencimento do Certificado
imprime ( string $pathXml = '', string $pathDestino = '', string $printer = '' ) : string imprime Imprime o documento eletrônico (NFe, CCe, Inut.)
sefazCCe ( string $chNFe = '', string $tpAmb = '2', string $xCorrecao = '', integer $nSeqEvento = 1, array &$aRetorno = [] ) : array sefazCCe Solicita a autorização da Carta de Correção
sefazCadastro ( string $siglaUF = '', string $tpAmb = '2', string $cnpj = '', string $iest = '', string $cpf = '', array &$aRetorno = [] ) : string sefazCadastro Busca os dados cadastrais de um emitente de NFe NOTA: Nem todas as Sefaz disponibilizam esse serviço
sefazCancela ( string $chNFe = '', string $tpAmb = '2', string $xJust = '', string $nProt = '', array &$aRetorno = [] ) : string sefazCancela Solicita o cancelamento da NFe
sefazConsultaChave ( string $chave = '', string $tpAmb = '2', array &$aRetorno = [], $salvaMensagens = true ) : string sefazConsultaChave Consulta o status da NFe pela chave de 44 digitos
sefazConsultaRecibo ( string $recibo = '', string $tpAmb = '2', array &$aRetorno = [], $saveMensagens = true ) : string sefazConsultaRecibo Consulta a situação de um Lote de NFe enviadas pelo recibo desse envio
sefazDistDFe ( string $fonte = 'AN', string $tpAmb = '2', string $cnpj = '', integer $ultNSU, integer $numNSU, array &$aRetorno = [] ) : string sefazDistDFe Serviço destinado à distribuição de informações resumidas e documentos fiscais eletrônicos de interesse de um ator.
sefazDownload ( string $chNFe = '', string $tpAmb = '', string $cnpj = '', array &$aRetorno = [] ) : string sefazDownload Solicita o download de NFe já manifestada
sefazECPP ( string $chNFe = '', string $tpAmb = '2', integer $nSeqEvento = 1, string $nProt = '', array &$aRetorno = [] ) : string sefazECPP Solicita o cancelamento do pedido de prorrogação do prazo de retorno de produtos de uma NF-e de remessa para industrialização por encomenda com suspensão do ICMS em operações interestaduais
sefazEPEC ( string | array $aXml, string $tpAmb = '2', string $siglaUF = 'AN', array &$aRetorno = [] ) : string sefazEPEC Solicita autorização em contingência EPEC TODO: terminar esse método
sefazEPP ( string $chNFe = '', string $tpAmb = '2', integer $nSeqEvento = 1, string $nProt = '', array $itens = [], array &$aRetorno = [] ) : string sefazEPP Solicita pedido de prorrogação do prazo de retorno de produtos de uma NF-e de remessa para industrialização por encomenda com suspensão do ICMS em operações interestaduais
sefazEnviaLote ( array $aXml, string $tpAmb = '2', string $idLote = '', array &$aRetorno = [], integer $indSinc, boolean $compactarZip = false, $salvarMensagens = true ) : string sefazEnviaLote Solicita a autorização de uso de Lote de NFe
sefazInutiliza ( integer $nSerie = 1, integer $nIni, integer $nFin, string $xJust = '', string $tpAmb = '2', array &$aRetorno = [], $salvarMensagens = true ) : string sefazInutiliza Solicita a inutilização de uma ou uma sequencia de NFe de uma determinada série
sefazManifesta ( string $chNFe = '', string $tpAmb = '2', string $xJust = '', string $tpEvento = '', array &$aRetorno = [] ) : string sefazManifesta Solicita o registro da manifestação de destinatário
sefazManutencaoCsc ( integer $indOp = '', string $tpAmb = '2', string $raizCNPJ = '', string $idCsc = '', string $codigoCsc = '', $saveXml = false, array &$aRetorno = [] ) : string sefazManutencaoCsc Manutenção do Código de Segurança do Contribuinte (Antigo Token)
sefazStatus ( string $siglaUF = '', string $tpAmb = '2', array &$aRetorno = [], $salvarMensagens = true ) : mixed sefazStatus Verifica o status do serviço da SEFAZ/SVC NOTA : Este serviço será removido no futuro, segundo da Receita/SEFAZ devido ao excesso de mau uso !!!
setModelo ( string $modelo = '55' ) setModelo
setSalvarMensagensEvento ( boolean $salvarMensagensEvento ) Se verdade gera os arquivos de logs do envio e resposta da requisição
validarXml ( string $xml = '' ) : boolean validarXml Valida qualquer xml do sistema NFe com seu xsd NOTA: caso não exista um arquivo xsd apropriado retorna false
verificaValidade ( string $pathXmlFile = '', array &$aRetorno = [] ) : boolean verificaValidade Verifica a validade de uma NFe recebida

Защищенные методы

Метод Описание
zAddProtMsg ( string $tagproc, string $tagmsg, string $xmlmsg, string $tagretorno, string $xmlretorno ) : string zAddProtMsg
zGetInfo ( string $xml ) : array zGetInfo Busca informações do XML para uso no sefazEPEC
zMakeQRCode ( string $chNFe, string $url, string $tpAmb, string $dhEmi, string $vNF, string $vICMS, string $digVal, string $token = '', string $cDest = '', string $idToken = '000001', string $versao = '100' ) : string zMakeQRCode Cria a chave do QR Code a ser usado na NFCe
zPutQRTag ( NFePHP\Common\Dom\Dom $dom, $saveFile ) : string zPutQRTag Monta a URI para o QRCode e coloca a tag no xml já assinado
zSefazEvento ( string $siglaUF = '', string $chNFe = '', string $tpAmb = '2', string $tpEvento = '', string $nSeqEvento = '1', string $tagAdic = '' ) : string zSefazEvento
zStr2Hex ( string $str ) : string zStr2Hex Converte string para haxadecimal ASCII

Приватные методы

Метод Описание
zTpEv ( string $tpEvento = '' ) : array zTpEv
zValidParamInut ( string $xJust, integer $nSerie, integer $nIni, integer $nFin ) zValidParamInut

Описание методов

addB2B() публичный Метод

addB2B Adiciona tags de comunicação B2B, especialmente ANFAVEA
public addB2B ( string $pathNFefile = '', string $pathB2Bfile = '', string $tagB2B = '' ) : string
$pathNFefile string
$pathB2Bfile string
$tagB2B string
Результат string

addCancelamento() публичный Метод

addCancelamento Adiciona a tga de cancelamento a uma NFe já autorizada NOTA: não é requisito da SEFAZ, mas auxilia na identificação das NFe que foram canceladas
public addCancelamento ( string $pathNFefile = '', string $pathCancfile = '', boolean $saveFile = false ) : string
$pathNFefile string
$pathCancfile string
$saveFile boolean
Результат string

addProtocolo() публичный Метод

addProtocolo Adiciona o protocolo de autorização de uso da NFe NOTA: exigência da SEFAZ, a nota somente é válida com o seu respectivo protocolo
public addProtocolo ( string $pathNFefile = '', string $pathProtfile = '', boolean $saveFile = false ) : string
$pathNFefile string
$pathProtfile string
$saveFile boolean
Результат string

assina() публичный Метод

assina Assina uma NFe
public assina ( string $xml = '', boolean $saveFile = false ) : string
$xml string
$saveFile boolean
Результат string

ativaContingencia() публичный Метод

ativaContingencia Ativa a contingencia SVCAN ou SVCRS conforme a sigla do estado ou EPEC
public ativaContingencia ( string $siglaUF = '', string $motivo = '', string $tipo = '' ) : boolean
$siglaUF string
$motivo string
$tipo string
Результат boolean

desativaContingencia() публичный Метод

desativaContingencia Desliga opção de contingência
public desativaContingencia ( ) : boolean
Результат boolean

enviaMail() публичный Метод

enviaMail Envia a NFe por email aos destinatários Caso $aMails esteja vazio serão obtidos os email do destinatário e os emails que estiverem registrados nos campos obsCont do xml
public enviaMail ( string $pathXml = '', array $aMails = [], string $templateFile = '', boolean $comPdf = false, string $pathPdf = '' ) : boolean
$pathXml string
$aMails array
$templateFile string path completo ao arquivo template html do corpo do email
$comPdf boolean se true o sistema irá renderizar o DANFE e anexa-lo a mensagem
$pathPdf string
Результат boolean

getImpostosIBPT() публичный Метод

getImpostosIBPT Consulta o serviço do IBPT para obter os impostos ao consumidor conforme Lei 12.741/2012
public getImpostosIBPT ( string $ncm = '', string $exTarif = '0', string $siglaUF = '' ) : array
$ncm string
$exTarif string
$siglaUF string
Результат array Array ( [Codigo] => 60063100 [UF] => SP [EX] => 0 [Descricao] => Outs.tecidos de malha de fibras sinteticas, crus ou branqueados [Nacional] => 13.45 [Estadual] => 18 [Importado] => 16.14 )

getLastMsg() публичный Метод

public getLastMsg ( )

getModelo() публичный Метод

getModelo Retorna o modelo de NFe atualmente setado
public getModelo ( ) : string
Результат string

getSalvarMensagensEvento() публичный Метод

getTimestampCert() публичный Метод

getTimestampCert Retorna o timestamp para a data de vencimento do Certificado
public getTimestampCert ( ) : integer
Результат integer

imprime() публичный Метод

imprime Imprime o documento eletrônico (NFe, CCe, Inut.)
public imprime ( string $pathXml = '', string $pathDestino = '', string $printer = '' ) : string
$pathXml string
$pathDestino string
$printer string
Результат string

sefazCCe() публичный Метод

sefazCCe Solicita a autorização da Carta de Correção
public sefazCCe ( string $chNFe = '', string $tpAmb = '2', string $xCorrecao = '', integer $nSeqEvento = 1, array &$aRetorno = [] ) : array
$chNFe string
$tpAmb string
$xCorrecao string
$nSeqEvento integer
$aRetorno array
Результат array

sefazCadastro() публичный Метод

sefazCadastro Busca os dados cadastrais de um emitente de NFe NOTA: Nem todas as Sefaz disponibilizam esse serviço
public sefazCadastro ( string $siglaUF = '', string $tpAmb = '2', string $cnpj = '', string $iest = '', string $cpf = '', array &$aRetorno = [] ) : string
$siglaUF string sigla da UF da empresa que queremos consultar
$tpAmb string
$cnpj string numero do CNPJ da empresa a ser consultada
$iest string numero da Insc. Est. da empresa a ser consultada
$cpf string CPF da pessoa física a ser consultada
$aRetorno array aRetorno retorno da resposta da SEFAZ em array
Результат string XML de retorno do SEFAZ

sefazCancela() публичный Метод

sefazCancela Solicita o cancelamento da NFe
public sefazCancela ( string $chNFe = '', string $tpAmb = '2', string $xJust = '', string $nProt = '', array &$aRetorno = [] ) : string
$chNFe string
$tpAmb string
$xJust string
$nProt string
$aRetorno array
Результат string

sefazConsultaChave() публичный Метод

sefazConsultaChave Consulta o status da NFe pela chave de 44 digitos
public sefazConsultaChave ( string $chave = '', string $tpAmb = '2', array &$aRetorno = [], $salvaMensagens = true ) : string
$chave string
$tpAmb string
$aRetorno array
Результат string

sefazConsultaRecibo() публичный Метод

sefazConsultaRecibo Consulta a situação de um Lote de NFe enviadas pelo recibo desse envio
public sefazConsultaRecibo ( string $recibo = '', string $tpAmb = '2', array &$aRetorno = [], $saveMensagens = true ) : string
$recibo string
$tpAmb string
$aRetorno array
Результат string

sefazDistDFe() публичный Метод

sefazDistDFe Serviço destinado à distribuição de informações resumidas e documentos fiscais eletrônicos de interesse de um ator.
public sefazDistDFe ( string $fonte = 'AN', string $tpAmb = '2', string $cnpj = '', integer $ultNSU, integer $numNSU, array &$aRetorno = [] ) : string
$fonte string sigla da fonte dos dados 'AN' e para alguns casos pode ser 'RS' e para alguns casos pode ser 'RS' e para alguns casos pode ser 'RS'
$tpAmb string tiupo de ambiente
$cnpj string
$ultNSU integer ultimo numero NSU que foi consultado
$numNSU integer numero de NSU que se quer consultar
$aRetorno array array com os dados do retorno
Результат string contento o xml retornado pela SEFAZ

sefazDownload() публичный Метод

sefazDownload Solicita o download de NFe já manifestada
public sefazDownload ( string $chNFe = '', string $tpAmb = '', string $cnpj = '', array &$aRetorno = [] ) : string
$chNFe string
$tpAmb string
$cnpj string
$aRetorno array
Результат string

sefazECPP() публичный Метод

sefazECPP Solicita o cancelamento do pedido de prorrogação do prazo de retorno de produtos de uma NF-e de remessa para industrialização por encomenda com suspensão do ICMS em operações interestaduais
public sefazECPP ( string $chNFe = '', string $tpAmb = '2', integer $nSeqEvento = 1, string $nProt = '', array &$aRetorno = [] ) : string
$chNFe string
$tpAmb string
$nSeqEvento integer
$nProt string
$aRetorno array
Результат string

sefazEPEC() публичный Метод

sefazEPEC Solicita autorização em contingência EPEC TODO: terminar esse método
public sefazEPEC ( string | array $aXml, string $tpAmb = '2', string $siglaUF = 'AN', array &$aRetorno = [] ) : string
$aXml string | array
$tpAmb string
$siglaUF string
$aRetorno array
Результат string

sefazEPP() публичный Метод

sefazEPP Solicita pedido de prorrogação do prazo de retorno de produtos de uma NF-e de remessa para industrialização por encomenda com suspensão do ICMS em operações interestaduais
public sefazEPP ( string $chNFe = '', string $tpAmb = '2', integer $nSeqEvento = 1, string $nProt = '', array $itens = [], array &$aRetorno = [] ) : string
$chNFe string
$tpAmb string
$nSeqEvento integer
$nProt string
$itens array
$aRetorno array
Результат string

sefazEnviaLote() публичный Метод

sefazEnviaLote Solicita a autorização de uso de Lote de NFe
public sefazEnviaLote ( array $aXml, string $tpAmb = '2', string $idLote = '', array &$aRetorno = [], integer $indSinc, boolean $compactarZip = false, $salvarMensagens = true ) : string
$aXml array
$tpAmb string
$idLote string
$aRetorno array
$indSinc integer
$compactarZip boolean
Результат string

sefazInutiliza() публичный Метод

sefazInutiliza Solicita a inutilização de uma ou uma sequencia de NFe de uma determinada série
public sefazInutiliza ( integer $nSerie = 1, integer $nIni, integer $nFin, string $xJust = '', string $tpAmb = '2', array &$aRetorno = [], $salvarMensagens = true ) : string
$nSerie integer
$nIni integer
$nFin integer
$xJust string
$tpAmb string
$aRetorno array
Результат string

sefazManifesta() публичный Метод

sefazManifesta Solicita o registro da manifestação de destinatário
public sefazManifesta ( string $chNFe = '', string $tpAmb = '2', string $xJust = '', string $tpEvento = '', array &$aRetorno = [] ) : string
$chNFe string
$tpAmb string
$xJust string
$tpEvento string
$aRetorno array
Результат string

sefazManutencaoCsc() публичный Метод

sefazManutencaoCsc Manutenção do Código de Segurança do Contribuinte (Antigo Token)
public sefazManutencaoCsc ( integer $indOp = '', string $tpAmb = '2', string $raizCNPJ = '', string $idCsc = '', string $codigoCsc = '', $saveXml = false, array &$aRetorno = [] ) : string
$indOp integer
$tpAmb string
$raizCNPJ string
$idCsc string
$codigoCsc string
$aRetorno array
Результат string

sefazStatus() публичный Метод

sefazStatus Verifica o status do serviço da SEFAZ/SVC NOTA : Este serviço será removido no futuro, segundo da Receita/SEFAZ devido ao excesso de mau uso !!!
public sefazStatus ( string $siglaUF = '', string $tpAmb = '2', array &$aRetorno = [], $salvarMensagens = true ) : mixed
$siglaUF string sigla da unidade da Federação
$tpAmb string tipo de ambiente 1-produção e 2-homologação
$aRetorno array parametro passado por referencia contendo a resposta da consulta em um array
Результат mixed string XML do retorno do webservice, ou false se ocorreu algum erro

setModelo() публичный Метод

Ajusta o modelo da NFe 55 ou 65
public setModelo ( string $modelo = '55' )
$modelo string

setSalvarMensagensEvento() публичный Метод

Se verdade gera os arquivos de logs do envio e resposta da requisição
public setSalvarMensagensEvento ( boolean $salvarMensagensEvento )
$salvarMensagensEvento boolean

validarXml() публичный Метод

validarXml Valida qualquer xml do sistema NFe com seu xsd NOTA: caso não exista um arquivo xsd apropriado retorna false
public validarXml ( string $xml = '' ) : boolean
$xml string path ou conteudo do xml
Результат boolean

verificaValidade() публичный Метод

verificaValidade Verifica a validade de uma NFe recebida
public verificaValidade ( string $pathXmlFile = '', array &$aRetorno = [] ) : boolean
$pathXmlFile string
$aRetorno array
Результат boolean

zAddProtMsg() защищенный Метод

zAddProtMsg
protected zAddProtMsg ( string $tagproc, string $tagmsg, string $xmlmsg, string $tagretorno, string $xmlretorno ) : string
$tagproc string
$tagmsg string
$xmlmsg string
$tagretorno string
$xmlretorno string
Результат string

zGetInfo() защищенный Метод

zGetInfo Busca informações do XML para uso no sefazEPEC
protected zGetInfo ( string $xml ) : array
$xml string
Результат array

zMakeQRCode() защищенный Метод

zMakeQRCode Cria a chave do QR Code a ser usado na NFCe
protected zMakeQRCode ( string $chNFe, string $url, string $tpAmb, string $dhEmi, string $vNF, string $vICMS, string $digVal, string $token = '', string $cDest = '', string $idToken = '000001', string $versao = '100' ) : string
$chNFe string
$url string
$tpAmb string
$dhEmi string
$vNF string
$vICMS string
$digVal string
$token string
$cDest string
$idToken string
$versao string
Результат string

zPutQRTag() защищенный Метод

zPutQRTag Monta a URI para o QRCode e coloca a tag no xml já assinado
protected zPutQRTag ( NFePHP\Common\Dom\Dom $dom, $saveFile ) : string
$dom NFePHP\Common\Dom\Dom
Результат string NOTA: O Campo QRCode está habilitado para uso a partir de 01/10/2015 homologação 03/11/2015 Produção

zSefazEvento() защищенный Метод

zSefazEvento
protected zSefazEvento ( string $siglaUF = '', string $chNFe = '', string $tpAmb = '2', string $tpEvento = '', string $nSeqEvento = '1', string $tagAdic = '' ) : string
$siglaUF string
$chNFe string
$tpAmb string
$tpEvento string
$nSeqEvento string
$tagAdic string
Результат string

zStr2Hex() защищенный статический Метод

zStr2Hex Converte string para haxadecimal ASCII
protected static zStr2Hex ( string $str ) : string
$str string
Результат string

Описание свойств

$errors публичное свойство

errrors
public string $errors
Результат string

$soapDebug публичное свойство

soapDebug
public string $soapDebug
Результат string

$urlPortal защищенное свойство

urlPortal Instância do WebService
protected string $urlPortal
Результат string