Platform & integrations
Accountant
1 endpoints
API for retrieving accountant registration data linked to a company. Useful for external accounting systems that need to fetch the complete data of the accountant responsible for a given company.
POST
/api/accountant/get_infoGet accountant info
Returns the complete registration data of the accountant linked to the given company. The accountant must be previously linked to the company (same CNPJ) and the email must match the registration.
Required headers
| Header | Type | Description |
|---|---|---|
| token | string | Company token or integrator B2B token |
| sign | string | MD5 signature: MD5(token + path + body + timestamp) |
| timestamp | string | Unix timestamp in seconds (5-minute window) |
Body
| Field | Type | Description |
|---|---|---|
| companyId * | int | ID of the company linked to the token |
| accountantId * | string | Accountant ObjectId (24 hex chars) |
| email * | string | Accountant email (must match the registration) |
* Required field.
Response fields
| Field | Type | Description |
|---|---|---|
| string | Primary accountant email | |
| officeDocumentType | string | Office document type: "CNPJ" or "CPF" |
| officeDocument | string | Office document (digits only) |
| officeName | string | Office corporate / business name |
| responsibleName | string | Name of the responsible accountant |
| crc | string | CRC number (Brazilian Regional Accounting Council) |
| accountantCpf | string | Accountant CPF (digits only) |
| workAddress | string | Business address |
| site | string | Office website |
| landline | string | Landline phone |
| mobile | string | Mobile phone |
| assistantName | string | Assistant name |
| assistantEmail | string | Assistant email |
| assistantPhone | string | Assistant phone |
| observations | string | Free-form registration notes |
Error responses
| Message | Cause |
|---|---|
| 会计师ID参数异常或不存在 | accountantId missing or not a valid ObjectId |
| 该会计师邮箱异常或不存在 | email invalid or not registered |
| 发票账号{companyId}异常或不存在 | companyId does not belong to the token user |
| 该会计师未绑定该发票账号 | Accountant is not linked to the given company |