Skip to main content
Após publicar o arquivo de configuração com php artisan vendor:publish --tag=suot-fiscal-config, o Laravel Bridge passa a ler todas as suas opções de config/suot-fiscal.php. Este documento descreve cada chave disponível, seus valores aceitos e as variáveis de ambiente correspondentes. Nenhuma opção precisa ser alterada diretamente no arquivo — o padrão é carregar todos os valores sensíveis via env(), mantendo o código-fonte livre de credenciais.

​
Arquivo de configuração completo

O arquivo abaixo representa o config/suot-fiscal.php publicado pelo Bridge com todos os campos e valores padrão: 
<?php

return [

    /*
    |--------------------------------------------------------------------------
    | Ambiente SEFAZ
    |--------------------------------------------------------------------------
    |
    | Define se as operações serão realizadas em homologação ou produção.
    | Use 'homologacao' durante o desenvolvimento e testes.
    | Altere para 'producao' somente após aprovação junto à SEFAZ.
    |
    | Valores aceitos: 'homologacao' | 'producao'
    |
    */
    'env' => env('SUOT_FISCAL_ENV', 'homologacao'),

    /*
    |--------------------------------------------------------------------------
    | CNPJ do emitente
    |--------------------------------------------------------------------------
    |
    | CNPJ da empresa emissora dos documentos fiscais, somente dígitos (14 chars).
    | Deve corresponder ao titular do certificado digital informado abaixo.
    |
    */
    'cnpj' => env('SUOT_FISCAL_CNPJ', ''),

    /*
    |--------------------------------------------------------------------------
    | Certificado digital A1
    |--------------------------------------------------------------------------
    |
    | Caminho para o arquivo PFX (.pfx) do certificado digital e sua senha.
    | Nunca armazene a senha diretamente neste arquivo — use env().
    |
    */
    'certificate_path'     => env('SUOT_FISCAL_CERT_PATH', ''),
    'certificate_password' => env('SUOT_FISCAL_CERT_PASSWORD', ''),

    /*
    |--------------------------------------------------------------------------
    | Autorizador SEFAZ
    |--------------------------------------------------------------------------
    |
    | Código do autorizador responsável pela UF do emitente.
    | Exemplos: 'SP', 'MG', 'RS', 'SVCAN' (SEFAZ Virtual Contingência AN),
    |           'SVCRS' (SEFAZ Virtual Contingência RS).
    |
    */
    'authorizer' => env('SUOT_FISCAL_AUTHORIZER', 'SP'),

    /*
    |--------------------------------------------------------------------------
    | Timeout HTTP
    |--------------------------------------------------------------------------
    |
    | Tempo máximo (em segundos) para aguardar resposta dos webservices da SEFAZ.
    | Valores muito baixos podem causar timeouts em momentos de lentidão do fisco.
    | Recomendado: entre 30 e 60 segundos.
    |
    */
    'timeout' => (int) env('SUOT_FISCAL_TIMEOUT', 45),

    /*
    |--------------------------------------------------------------------------
    | Retry policy
    |--------------------------------------------------------------------------
    |
    | Configuração de tentativas automáticas em caso de falha técnica transitória
    | (timeout, erro 500 do webservice). Rejeições da SEFAZ não são repetidas.
    |
    */
    'retry' => [
        'attempts' => (int) env('SUOT_FISCAL_RETRY_ATTEMPTS', 2),
        'delay_ms' => (int) env('SUOT_FISCAL_RETRY_DELAY_MS', 1500),
    ],

];

​
Referência das opções

​
env
string
required
Ambiente de operação junto à SEFAZ.
  • 'homologacao' — Webservices de teste. Documentos não têm validade jurídica.
  • 'producao' — Webservices reais. Documentos são válidos perante o fisco.
Padrão: 'homologacao'
​
cnpj
string
required
CNPJ do emitente, contendo somente os 14 dígitos numéricos (sem pontuação). Deve ser o mesmo CNPJ titular do certificado digital configurado em certificate_path.Exemplo: '12345678000199'
​
certificate_path
string
required
Caminho absoluto para o arquivo de certificado digital no formato PFX/PKCS#12 (extensão .pfx ou .p12). O processo PHP (ou o usuário do servidor web) precisa ter permissão de leitura neste arquivo.Exemplo: '/var/www/certs/certificado-empresa.pfx'
​
certificate_password
string
required
Senha do arquivo PFX. Nunca informe este valor diretamente no arquivo de configuração — leia sempre de env('SUOT_FISCAL_CERT_PASSWORD').
​
authorizer
string
required
Código do autorizador (polo de autorização) da SEFAZ responsável pela UF do emitente. Os valores mais comuns para CT-e e MDF-e são:
CódigoDescrição
'SP'SEFAZ São Paulo
'MG'SEFAZ Minas Gerais
'RS'SEFAZ Rio Grande do Sul
'SVCAN'SEFAZ Virtual de Contingência — Ambiente Nacional
'SVCRS'SEFAZ Virtual de Contingência — Rio Grande do Sul
Padrão: 'SP'
​
timeout
integer
Tempo limite em segundos para cada requisição HTTP aos webservices da SEFAZ. Se o webservice não responder dentro deste prazo, uma InfrastructureException com código de timeout é lançada.Padrão: 45
​
retry.attempts
integer
Número máximo de tentativas automáticas em caso de falha técnica transitória (timeout ou erro de servidor). A contagem não inclui a tentativa inicial — 2 significa uma tentativa inicial mais até 2 repetições.Rejeições retornadas pela SEFAZ não são repetidas automaticamente.Padrão: 2
​
retry.delay_ms
integer
Intervalo em milissegundos entre cada tentativa de retry. O valor é aplicado como espera fixa antes de cada repetição.Padrão: 1500
Nunca escreva o valor de certificate_password diretamente no arquivo config/suot-fiscal.php ou em qualquer arquivo versionado no repositório. Use sempre env('SUOT_FISCAL_CERT_PASSWORD') e gerencie o valor real por meio de variáveis de ambiente seguras ou um gerenciador de segredos (AWS Secrets Manager, HashiCorp Vault, Laravel Secrets, etc.).

​
Variáveis de ambiente

Todas as opções de configuração possuem uma variável de ambiente correspondente. Use a tabela abaixo como referência ao configurar seu .env, CI/CD ou plataforma de deploy.
Chave em config/suot-fiscal.phpVariável de ambienteValor padrão
envSUOT_FISCAL_ENVhomologacao
cnpjSUOT_FISCAL_CNPJ(vazio)
certificate_pathSUOT_FISCAL_CERT_PATH(vazio)
certificate_passwordSUOT_FISCAL_CERT_PASSWORD(vazio)
authorizerSUOT_FISCAL_AUTHORIZERSP
timeoutSUOT_FISCAL_TIMEOUT45
retry.attemptsSUOT_FISCAL_RETRY_ATTEMPTS2
retry.delay_msSUOT_FISCAL_RETRY_DELAY_MS1500
Em ambientes com múltiplos emitentes (multi-tenant), é possível instanciar os Handlers diretamente com uma FiscalConfig diferente por requisição, sem depender das variáveis globais do config/suot-fiscal.php. Consulte a documentação de Configuração do SDK base para mais detalhes.
Antes de alternar para producao, verifique todos os itens da lista de verificação em Guia de produção: validade do certificado, CNPJ habilitado na SEFAZ, timeout adequado ao ambiente e monitoramento de InfrastructureException.