Anexos, notas fiscais, schemas e espaços
Os arquivos anexados aos registros, as notas fiscais recebidas, finance_schemas_get, o catálogo dos campos que cada tool devolve — o que pedir em fields —, e finance_workspaces_list, os espaços de onde sai o workspace_id das outras tools.
Famílias nesta página
| Família | Tools | read | write | destructive |
|---|---|---|---|---|
attachments — Anexos | 7 | 3 | 2 | 2 |
fiscal_documents — Notas fiscais recebidas | 2 | 2 | 0 | 0 |
schemas — Catálogo de campos | 1 | 1 | 0 | 0 |
workspaces — Espaços | 1 | 1 | 0 | 0 |
attachments
| Tool | Tipo | Permissão | Endpoint | O que faz |
|---|---|---|---|---|
finance_attachments_list | read | attachments.list | GET /v1/attachments | List attachments (metadata only). |
finance_attachments_get | read | attachments.list | GET /v1/attachments/{attachment_id} | Fetch one attachment's metadata, including download_url. |
finance_attachments_download | read | attachments.download | GET /v1/attachments/{attachment_id}/download | Locate an attachment's bytes. |
finance_attachments_upload | write | attachments.create | POST /v1/attachments | Upload a file (pdf, png, jpg, xml, ofx, csv, xlsx; max 10 MB) as an attachment. |
finance_attachments_delete | destructive | attachments.delete | DELETE /v1/attachments/{attachment_id} | Delete an attachment (file and metadata). |
finance_attachments_link | write | attachments.update | POST /v1/attachments/{attachment_id}/links | Attach the file to a payable, receivable or transaction: type names the kind of record and id its id. |
finance_attachments_unlink | destructive | attachments.update | DELETE /v1/attachments/{attachment_id}/links | Detach the file from a payable, receivable or transaction (type + id of the record). |
fiscal_documents
| Tool | Tipo | Permissão | Endpoint | O que faz |
|---|---|---|---|---|
finance_fiscal_documents_list | read | fiscal-documents.list | GET /v1/fiscal-documents | List received fiscal documents (NF-e / NFS-e issued to the workspace's companies). |
finance_fiscal_documents_get | read | fiscal-documents.show | GET /v1/fiscal-documents/{id} | Fetch one received fiscal document. |
schemas
| Tool | Tipo | Permissão | Endpoint | O que faz |
|---|---|---|---|---|
finance_schemas_get | read | — (nenhuma) | — (local) | Describe a schema of the Finance API contract: the fields a tool returns (PayableDetailV1, FinancialTransactionV1…) or accepts. |
workspaces
| Tool | Tipo | Permissão | Endpoint | O que faz |
|---|---|---|---|---|
finance_workspaces_list | read | — (nenhuma) | — (local) | List the workspaces of this organization you can act on. |
Os campos de cada recurso estão na Referência da API e em finance_schemas_get.
Uma tool que você não pode rodar não aparece em tools/list. Se uma daqui não está lá, veja Autenticação.