Download the PHP package pairus/product-data without Composer

On this page you can find all versions of the php package pairus/product-data. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of pairus/product-data

Informations about the package product-data

PAIRUS Product Data SDK para PHP 🐘

Latest Version on Packagist PHP Version

SDK oficial da PAIRUS Soluções Tecnológicas para PHP moderno (8.1+). Integração nativa de alta performance com o catálogo global de produtos GTIN/EAN, motor preditivo de inteligência artificial para a Reforma Tributária (IBS, CBS e Imposto Seletivo), saneamento fiscal em lote, emissão de NF-e / NFC-e com Autocura SEFAZ e NFS-e Nacional.

⚡ Quickstart em 3 Linhas

🧭 Formas de Uso e Flexibilidade

O SDK foi desenhado para respeitar as melhores práticas do PHP moderno (tipagem estrita, DTOs imutáveis public readonly, named arguments e suporte a arrays associativos flexíveis):

📚 Guia de Recursos

1. Produtos e Catálogo Global

2. Predição Fiscal & Reforma Tributária (IBS / CBS / IS)

Calcula automaticamente a matriz tributária completa para 27 UFs e rotas interestaduais:

3. Saneamento Fiscal em Lote

Audite e higienize cadastros inteiros de ERPs e e-commerces em uma única requisição:

4. Emissão de NF-e / NFC-e com Autocura SEFAZ

Toda emissão envia o cabeçalho Idempotency-Key. Sem chave informada, o SDK gera um UUID e o reutiliza nas retentativas automáticas: se a primeira tentativa já tiver emitido a nota, a API devolve essa mesma nota ($nfce->repeticaoIdempotente === true, sem novo faturamento) em vez de emitir outra. A chave vale por 24 h e é liberada se a nota for rejeitada.

Contingência off-line da NFC-e: com a opção ativada na conta (tela de emissão da Área do Cliente), a venda não trava quando a SEFAZ não responde: a resposta vem com sucesso verdadeiro, $nfce->statusSefaz igual a CONTINGENCIA (cStat 9, código da PAIRUS) e o DANFE com a tarja de contingência e a via do estabelecimento, sem consumir créditos. A nota é transmitida automaticamente depois, e o desfecho chega por webhook (nfe.autorizada, nfe.contingencia_rejeitada, nfe.substituida_cancelada, nfe.substituida_inutilizada, nfe.regularizacao_manual). Para recusar a contingência numa venda, envie 'permitir_contingencia' => false.

Autorização com alerta (cStat 120, NT 2026.002): a nota está autorizada e não deve ser reemitida; os alertas da SEFAZ (cMsg/xMsg, até 5) vêm em $nfce->alertasSefaz. Venda em marketplace (NT 2020.006): informe o marketplace no payload, 'intermediador' => ['cnpj' => '03007331000141', 'id_cadastro' => 'MINHA-LOJA'], para a nota sair com indIntermed=1 e o grupo infIntermed; o campo indicador_presenca define o indPres (padrão: 1 na NFC-e e 2 na NF-e). DIFAL: na NF-e interestadual a consumidor final não contribuinte, a API gera o grupo ICMSUFDest com a alíquota modal da UF de destino; para outra alíquota interna ou FCP, envie no item 'difal' => ['aliquota_interna_destino' => 19.0, 'fcp_percentual' => 2.0].

5. NFS-e Nacional de Serviços

6. DF-e Inbound & Captura Ativa SEFAZ (Gestão de Compras)

Capture ativamente as notas fiscais emitidas por fornecedores contra o CNPJ da sua empresa via WebService NFeDistribuicaoDFe da SEFAZ Nacional:

7. Validação Segura de Webhooks (HMAC-SHA256)

📋 Tabela de Parâmetros: Obrigatório vs. Opcional

Predição Fiscal ($pairus->fiscal->predict)

Parâmetro Tipo Obrigatório? Descrição & Regra Fiscal
regimeTributario string Sim 'simples_nacional', 'lucro_presumido' ou 'lucro_real'.
ufOrigem string Sim Sigla da UF do emitente (ex: 'SP').
ufDestino string Não Sigla da UF do destinatário. Se omitido, assume operação interna ($ufOrigem).
finalidade string Não 'revenda' (padrão), 'consumo_final' ou 'industrializacao'.
destinatarioContribuinte bool Não Define aplicação de DIFAL / ST (padrão: true).
gtin string Não* Código de barras GTIN/EAN numérico (8, 12, 13 ou 14 dígitos).
xProd string Não* Descrição comercial da mercadoria (para predição por IA/RAG).
ncm string Não NCM atual de 8 dígitos para validação e auditoria.
cest string Não Código CEST de 7 dígitos para validação de ICMS-ST.
itens array Não Lista de itens para cálculo consolidado de NF-e completa em lote.

*Nota: Pelo menos um identificador (gtin, xProd ou ncm) deve ser informado no modo individual.

NFS-e Nacional ($pairus->nfse->emitir)

Parâmetro Tipo Obrigatório? Descrição
prestador.cnpj string Sim CNPJ do emissor prestador de serviços.
tomador.cpf_cnpj string Sim CPF ou CNPJ do tomador do serviço.
tomador.razao_social string Sim Razão social ou nome completo do tomador.
servico.discriminacao string Sim Descrição clara dos serviços prestados.
servico.valor_servicos float Sim Valor bruto total dos serviços (R$).
servico.item_lista_servico string Não Item da LC 116/2003 (ex: '01.01').
servico.codigo_tributacao_municipio string Não Código municipal de tributação da prefeitura.
servico.aliquota_iss float Não Alíquota nominal do ISS (ex: 2.0 para 2%).
servico.iss_retido bool Não True se o ISS for retido na fonte pelo tomador.

Manifestação do Destinatário ($pairus->dfe->manifestar)

Parâmetro Tipo Obrigatório? Descrição & Regras Fiscais
chaveAcesso string Sim Chave de 44 dígitos da NF-e emitida pelo fornecedor.
cnpj string Sim CNPJ da sua empresa compradora/destinatária.
tipoEvento string Sim '210210' (Ciência), '210200' (Confirmação), '210220' (Desconhecimento), '210240' (Não Realizada).
justificativa string Condicional Obrigatória estritamente para '210240' (mínimo de 15 caracteres).
ambiente string Não 'producao' (padrão) ou 'homologacao'.

🛠️ Exemplos em Frameworks

Laravel (Controller & Service)

WordPress / WooCommerce

🛡️ Tratamento de Erros e Padrão SEFAZ

Todas as exceções estendem PairusApiException, expondo os códigos de status e descrições do layout SEFAZ:

📄 Licença

Distribuído sob a licença MIT. Consulte o arquivo LICENSE para mais detalhes.

All versions of product-data with dependencies

PHP Build Version
Package Version
Requires php Version >=8.1.0
ext-json Version *
ext-curl Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package pairus/product-data contains the following files

Loading the files please wait ...