TF Fiscal

Plataforma e integrações

Contador

1 endpoints

API para consulta dos dados de cadastro de contadores vinculados a uma empresa. Útil para sistemas contábeis externos que precisam buscar dados completos do contador responsável por uma determinada empresa.

POST/api/accountant/get_info

Obter dados do contador

Retorna os dados completos de cadastro do contador vinculado à empresa informada. O contador precisa estar previamente vinculado à empresa (mesmo CNPJ) e o e-mail informado deve coincidir com o cadastro.

Headers obrigatórios

HeaderTipoDescrição
tokenstringToken da empresa ou token B2B do integrador
signstringAssinatura MD5: MD5(token + path + body + timestamp)
timestampstringUnix timestamp em segundos (janela de 5 minutos)

Body

CampoTipoDescrição
companyId *intID da empresa vinculada ao token
accountantId *stringObjectId do contador (24 hex)
email *stringE-mail do contador (deve coincidir com o cadastro)

* Campo obrigatório.

Campos da Resposta

CampoTipoDescrição
emailstringE-mail principal do contador
officeDocumentTypestringTipo do documento do escritório: "CNPJ" ou "CPF"
officeDocumentstringDocumento do escritório (apenas dígitos)
officeNamestringRazão social / nome do escritório
responsibleNamestringNome do contador responsável
crcstringNúmero do CRC (Conselho Regional de Contabilidade)
accountantCpfstringCPF do contador (apenas dígitos)
workAddressstringEndereço comercial
sitestringSite do escritório
landlinestringTelefone fixo
mobilestringCelular
assistantNamestringNome do assistente
assistantEmailstringE-mail do assistente
assistantPhonestringTelefone do assistente
observationsstringObservações livres do cadastro

Respostas de erro

MensagemCausa
会计师ID参数异常或不存在accountantId ausente ou não é um ObjectId válido
该会计师邮箱异常或不存在email inválido ou não cadastrado
发票账号{companyId}异常或不存在companyId não pertence ao usuário do token
该会计师未绑定该发票账号O contador não está vinculado à empresa informada