平台与集成
会计接口
1 个接口
用于查询与企业绑定的会计师注册数据的 API。适用于需要获取负责某企业会计师完整资料的外部财务系统。
POST
/api/accountant/get_info获取会计师信息
返回与指定企业绑定的会计师的完整注册数据。会计师必须事先绑定到该企业(相同 CNPJ),且提供的邮箱必须与注册一致。
必需请求头
| 请求头 | 类型 | 说明 |
|---|---|---|
| token | string | 企业 token 或集成商 B2B token |
| sign | string | MD5 签名:MD5(token + path + body + timestamp) |
| timestamp | string | Unix 时间戳(秒,5 分钟窗口) |
Body
| 字段 | 类型 | 说明 |
|---|---|---|
| companyId * | int | 绑定到 token 的企业 ID |
| accountantId * | string | 会计师 ObjectId(24 位十六进制) |
| email * | string | 会计师邮箱(必须与注册一致) |
* 必填字段。
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| string | 会计师主邮箱 | |
| officeDocumentType | string | 事务所证件类型:"CNPJ" 或 "CPF" |
| officeDocument | string | 事务所证件(仅数字) |
| officeName | string | 事务所法人名 / 名称 |
| responsibleName | string | 负责会计师姓名 |
| crc | string | CRC 号(巴西地区会计委员会) |
| accountantCpf | string | 会计师 CPF(仅数字) |
| workAddress | string | 办公地址 |
| site | string | 事务所网站 |
| landline | string | 固定电话 |
| mobile | string | 手机 |
| assistantName | string | 助理姓名 |
| assistantEmail | string | 助理邮箱 |
| assistantPhone | string | 助理电话 |
| observations | string | 注册自由备注 |
错误响应
| 消息 | 原因 |
|---|---|
| 会计师ID参数异常或不存在 | accountantId 缺失或不是有效的 ObjectId |
| 该会计师邮箱异常或不存在 | email 无效或未注册 |
| 发票账号{companyId}异常或不存在 | companyId 不属于该 token 用户 |
| 该会计师未绑定该发票账号 | 会计师未绑定到指定企业 |