document

A query Document retorna um document específico a partir do seu id.

Parâmetros

Argumento	Tipo	Obrigatório	Descrição
id	String	Sim	Identificador do document, em hash, como retornado por `documents` ou `document`
fields	[String]	Não	Campos a incluir no `data`. Quando omitido, retorna todos os campos públicos do document. Não afeta `files`.

Campos de retorno

Campo	Tipo	Descrição
id	String	Identificador do document, em hash
data	Any	O document em JSON, com os campos públicos projetados
files	[DocumentFileNode]	Arquivos anexados ao document. Lista vazia quando não há nenhum
files.url	String	URL pública do arquivo
files.createdAt	DateTime	Data em que o arquivo foi vinculado ao document, em UTC

Quando o document não existe, a query retorna null sem reportar erro.

📘
Documents vinculados a carrinho e pedido
Os ids listados em documentIds do carrinho, dos produtos do carrinho e dos pedidos do cliente podem ser consultados nesta query. Um id de document já removido retorna null, e quem exibe os documents deve tratar esse caso. Para consultar vários ids numa única requisição, use aliases (doc1: document(id: "...") { ... }).

Exemplo

query {
  document(id: "eyJFbnRpdHkiOiJEb2N1bWVudFZhbHVlIiwiSWQiOjQ1MDF9") {
    id
    data
    files {
      url
      createdAt
    }
  }
}

Mostrar resposta

{
  "data": {
    "document": {
      "id": "eyJFbnRpdHkiOiJEb2N1bWVudFZhbHVlIiwiSWQiOjQ1MDF9",
      "data": {
        "sku": "ABC-123",
        "cor": "Azul"
      },
      "files": [
        {
          "url": "https://minhaloja.fbitsstatic.net/documents/3f6c2a1e-8b4d-4f0a-9c2e-1d5b7a9e0c42.pdf",
          "createdAt": "2026-09-21T14:03:12Z"
        }
      ]
    }
  }
}