Séries de numeração na API

Sem uma série ativa do tipo fiscale, a emissão devolve 409 no_series_configured.

A primeira fatura em 6 passos

GET /v1/series lista as séries de numeração configuradas para o tenant.
A emissão exige pelo menos uma série ATIVA do tipo fiscale.
Sem ela, POST /v1/invoices devolve 409 no_series_configured.
As séries são criadas e ativadas no painel, não através da API.

Todos os endpoints

Método	Endpoint	Scope	Idempotency-Key	Pedidos / minuto
GET	/series Listar as séries de numeração	invoices:read	—	120

O que é a API 4invoices

bash
curl -sS https://api.4invoices.net/v1/series \
  -H "Authorization: Bearer $ACCESS_TOKEN"

# Tem de existir pelo menos uma série ATIVA do tipo "fiscale", senão
# POST /invoices devolve 409 no_series_configured.

https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json

Erros

Estado	Tipo	Código
409	conflict_error	no_series_configured

Erros frequentes

A resposta de POST /v1/invoices inclui series e number — registe ambos para a reconciliação.
Uma anulação (storno) consome um novo número da série; o número da fatura original nunca é reutilizado.
As faturas pró-forma usam uma numeração separada das séries fiscais, pelo que não consomem números fiscais.
Não presuma um formato de número: trate number como uma string opaca, não como um inteiro.

Perguntas e respostas para desenvolvedores

Posso criar uma série através da API?

Não. A API apenas lê séries. A criação e ativação fazem-se no painel, porque a numeração fiscal é uma decisão de conformidade.

E se tiver várias séries ativas?

É usada a série predefinida configurada no painel. A emissão não escolhe sozinha entre séries ambíguas.

Porque é que no_series_configured é um 409 e não um 422?

É um conflito de estado da conta, não um problema nos dados que enviou. O seu payload é válido; falta a configuração.

Ver também