--- title: 3.2. Escrituradores url: https://docs.vehub.com.br/API/Nota%20Comercial/3.%20Refer%C3%AAncias/3.2.%20Escrituradores/ --- # 3.2. Escrituradores ## 🔗 Endpoint | Método | URL | |--------|-----| | ![GET](https://img.shields.io/badge/GET-green) | `/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 ```bash curl -X GET https://api.vehub.com.br/public/v1/escrituradores \ -H "Authorization: Bearer {seu_token}" \ -H "GrupoEconomico: {seu_grupo_economico}" ``` --- ## 📥 Responses ### ✅ 200 OK ```json [ { "id": 1, "nome": "Escriturador Central S.A.", "documento": "11222333000181" }, { "id": 2, "nome": "Registradora Digital LTDA", "documento": "44555666000177" } ] ``` #### Detalhamento dos Campos | Campo | Tipo | Descrição | |-------|------|-----------| | id | integer | Identificador único do escriturador | | nome | string | Razão social do escriturador | | documento | string | CNPJ do escriturador (somente números) | --- ### ❌ 401 Unauthorized ```json { "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."] } ```