# Lista documentos fiscais eletrônicos emitidos

Retorna uma lista paginada de documentos fiscais eletrônicos emitidos, com filtros opcionais por data, busca, ordenação e paginação.

Endpoint: GET /api/v3/nfes/emitted-documents
Version: 3.0.0
Security: OAuth2

## Header parameters:

  - `CPlug-Company-Id` (number, required)
    Id da Empresa (Company).

Você pode localizar os IDs das empresas no _endpoint_ de listagem de empresas.
    Example: 12

## Query parameters:

  - `date_start` (string)
    Data inicial para filtrar os documentos (data de emissão).
    Example: "2000-01-01"

  - `date_end` (string)
    Data final para filtrar os documentos (data de emissão).
    Example: "2025-12-31"

  - `search` (string)
    Termo de busca para filtrar documentos (número, nome do cliente, CNPJ do cliente, id da venda).
    Example: "9001"

  - `min_value` (number)
    Filtro pelo valor mínimo do documento.
    Example: 100

  - `max_value` (number)
    Filtro pelo valor máximo do documento.
    Example: 1000

  - `order_by_field` (string)
    Campo para ordenação dos documentos.
Exemplo:
  - number Número do documento
  - emitted_at Data de emissão
  - customer Nome do cliente
    Enum: "emitted_at", "number", "serie", "model", "value", "customer"

  - `order_by_type` (string)
    Tipo de ordenação.
Exemplo:
  - asc Ascendente
  - desc Descendente
    Enum: "asc", "desc"

  - `page` (number)
    Indica a página da paginação.

  - `per_page` (number)
    Indica a quantidade de itens por página.

## Response 200 fields (application/json):

  - `data` (object, required)

  - `data.documents` (array)
    Lista de documentos fiscais eletrônicos emitidos

  - `data.documents.id` (integer, required)
    ID único do documento
    Example: 447

  - `data.documents.key` (string,null, required)
    Chave de acesso do documento fiscal
    Example: "12345678901234567890123456789012345678901234"

  - `data.documents.emitted_at` (string, required)
    Data e hora de emissão do documento
    Example: "2025-07-03 14:01:48"

  - `data.documents.number` (string, required)
    Número do documento fiscal
    Example: "12345"

  - `data.documents.serie` (string, required)
    Série do documento fiscal
    Example: "1"

  - `data.documents.model` (integer,null, required)
    Modelo do documento fiscal
    Example: 55

  - `data.documents.value` (object, required)
    Valor do documento fiscal

  - `data.documents.value.amount` (number, required)
    Valor expresso como um número decimal das principais unidades monetárias
    Example: 99.95

  - `data.documents.value.currency` (string, required)
    Código de moeda de 3 letras conforme definido pela ISO-4217
    Example: "BRL"

  - `data.documents.customer` (object, required)
    Dados do cliente/destinatário

  - `data.documents.customer.name` (string,null, required)
    Nome/razão social do cliente
    Example: "Cliente Teste Ltda"

  - `data.documents.customer.cnpj` (string,null, required)
    CNPJ do cliente
    Example: "12345678000190"

  - `data.documents.status` (string, required)
    Status do documento.

- Pending: Pendente
- Canceled: Cancelado
- Inutilized: Inutilizado
- Transmitted: Transmitido
- Failed: Falha
    Example: "Pending"

  - `data.documents.download` (string, required)
    URL para download do documento
    Example: "http://erp.connectplug.com.br/file/eyJpdiI6IkR1Tk5kYXhPNWVvRGtqbElJVC9iVUE9PSIsInZhbHVlIjoiUzZoOXVUZVhHQVUxb1FQUDV4a0l4UT09IiwibWFjIjoiN2JkNmM0ZTU0MmEwOWZiZWQ2YTQxNThhZmM3YTkwNDU4NjcwYWQ1MDkzMDc1MWVkYTIwYzkzMjg3YzkzOThkYyIsInRhZyI6IiJ9/download"

  - `data.documents.download_xml_canceled` (string,null, required)
    URL para download do XML de cancelamento

  - `meta` (object, required)
    Representa as informações de Metadado da paginação da listagem.

  - `meta.current_page` (integer, required)
    Página atual na paginação.
    Example: 1

  - `meta.last_page` (integer, required)
    Quantidade total de páginas.
    Example: 10

  - `meta.per_page` (integer, required)
    Quantidade de resultados por página.
    Example: 20

  - `meta.total` (integer, required)
    Quantidade total de itens.
    Example: 200

## Response 400 fields (application/json):

  - `code` (string, required)
    Código de erro.
    Example: "missing_headers"

  - `message` (string)
    Descrição do erro.
    Example: "error message"

  - `meta` (array)
    Dados adicionais sobre o erro.

## Response 422 fields (application/json):

  - `code` (string, required)
    Código de erro.
    Example: "uneditable_entity"

  - `message` (string)
    Descrição do erro.
    Example: "description error"

  - `meta` (array)
    Dados adicionais sobre o erro.

  - `meta.field` (string, required)
    Nome do campo no qual existe um erro de validação.
    Example: "name"

  - `meta.validations` (array)

  - `meta.validations.type` (string, required)
    Tipo da validação aplicada.
    Example: "Required"

  - `meta.validations.value` (array)
    Tipo de valor aplicável (esse campo pode ser vazio).


## Response 401 fields

## Response 404 fields