TF Fiscal

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_info

Get 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

HeaderTypeDescription
tokenstringCompany token or integrator B2B token
signstringMD5 signature: MD5(token + path + body + timestamp)
timestampstringUnix timestamp in seconds (5-minute window)

Body

FieldTypeDescription
companyId *intID of the company linked to the token
accountantId *stringAccountant ObjectId (24 hex chars)
email *stringAccountant email (must match the registration)

* Required field.

Response fields

FieldTypeDescription
emailstringPrimary accountant email
officeDocumentTypestringOffice document type: "CNPJ" or "CPF"
officeDocumentstringOffice document (digits only)
officeNamestringOffice corporate / business name
responsibleNamestringName of the responsible accountant
crcstringCRC number (Brazilian Regional Accounting Council)
accountantCpfstringAccountant CPF (digits only)
workAddressstringBusiness address
sitestringOffice website
landlinestringLandline phone
mobilestringMobile phone
assistantNamestringAssistant name
assistantEmailstringAssistant email
assistantPhonestringAssistant phone
observationsstringFree-form registration notes

Error responses

MessageCause
会计师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