3.2. Escrituradores¶

🔗 Endpoint¶

Método	URL
	/public/v1/escrituradores

🧾 Descrição¶

Retorna a lista de escrituradores disponíveis para registrar Notas Comerciais no grupo econômico.

Não é possível cadastrar novos escrituradores via API.

O escriturador é a entidade responsável pela escrituração e registro da Nota Comercial. Todo emitente precisa ser habilitado em ao menos um escriturador antes de poder emitir uma NC.

🧪 Exemplo de cURL¶

curl -X GET https://api.vehub.com.br/public/v1/escrituradores \
  -H "Authorization: Bearer {seu_token}" \
  -H "GrupoEconomico: {seu_grupo_economico}"

📥 Responses¶

✅ 200 OK¶

[
  {
    "id": 1,
    "nome": "Escriturador Central S.A.",
    "documento": "11222333000181"
  },
  {
    "id": 2,
    "nome": "Registradora Digital LTDA",
    "documento": "44555666000177"
  }
]

Detalhamento dos Campos¶

❌ 401 Unauthorized¶

{
  "tipo": "https://tools.ietf.org/html/rfc9110#section-15.6.2",
  "titulo": "Não autorizado",
  "status": 401,
  "erros": ["Token de autenticação inválido ou expirado."]
}