Ambientes

Todo o estado da biblioteca vive no %Nfse.Client{}: certificado, ambiente, tempo de espera e opções do Req. Não há processo, Application nem configuração global, então vários emitentes convivem no mesmo node com um cliente cada.

{:ok, client} =
  Nfse.Client.new(
    certificate: certificate,
    environment: :restricted
  )

Produção restrita e produção

A produção restrita é o ambiente de testes da Receita. Os documentos emitidos ali não têm validade jurídica. Comece por ela e só troque para :production com o fluxo completo (emitir, conferir, cancelar, importar) funcionando.

O ambiente do cliente decide o tpAmb da DPS. Você pode omitir tp_amb; se informar um valor diferente do ambiente do cliente, Nfse.DPS.build/2 devolve o erro :environment antes de assinar, para que um documento de produção nunca vá para a produção restrita, nem o contrário.

Nfse.Client.tp_amb(client)
#=> "2"

O caminho da Sefin na produção restrita (/API/SefinNacional, como no portal gov.br, ou /SefinNacional) ainda depende da execução contra o ambiente real. Veja a seção "Rodando contra a produção restrita" do README.

Tempo de espera

receive_timeout vale por requisição e o padrão é 60_000 milissegundos. A emissão é síncrona: a Sefin assina, numera e devolve a nota na mesma resposta, então um prazo curto demais aumenta os casos de resultado incerto, tratados em Conferir após timeout.

{:ok, client} =
  Nfse.Client.new(
    certificate: certificate,
    environment: :production,
    receive_timeout: 90_000
  )

Opções do Req

req_options é repassado ao Req e vence os padrões da biblioteca. Serve, por exemplo, para registrar métricas ou apontar um Req.Test nos testes do seu sistema:

{:ok, client} =
  Nfse.Client.new(
    certificate: certificate,
    environment: :restricted,
    req_options: [plug: {Req.Test, MeuApp.NfseStub}]
  )

Dois cuidados:

• retry: informado ali não religa o reenvio de uma escrita. A política de POST da biblioteca vale sempre, porque repetir uma emissão pode duplicar a nota fiscal.
• Um finch: [name: MeuFinch] substitui o pool inteiro. Quem faz isso precisa iniciar o próprio Finch com o certificado em conn_opts: [transport_opts: [cert: ..., key: ...]], senão o mTLS não acontece.