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_infoObter 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
| Header | Tipo | Descrição |
|---|---|---|
| token | string | Token da empresa ou token B2B do integrador |
| sign | string | Assinatura MD5: MD5(token + path + body + timestamp) |
| timestamp | string | Unix timestamp em segundos (janela de 5 minutos) |
Body
| Campo | Tipo | Descrição |
|---|---|---|
| companyId * | int | ID da empresa vinculada ao token |
| accountantId * | string | ObjectId do contador (24 hex) |
| email * | string | E-mail do contador (deve coincidir com o cadastro) |
* Campo obrigatório.
Campos da Resposta
| Campo | Tipo | Descrição |
|---|---|---|
| string | E-mail principal do contador | |
| officeDocumentType | string | Tipo do documento do escritório: "CNPJ" ou "CPF" |
| officeDocument | string | Documento do escritório (apenas dígitos) |
| officeName | string | Razão social / nome do escritório |
| responsibleName | string | Nome do contador responsável |
| crc | string | Número do CRC (Conselho Regional de Contabilidade) |
| accountantCpf | string | CPF do contador (apenas dígitos) |
| workAddress | string | Endereço comercial |
| site | string | Site do escritório |
| landline | string | Telefone fixo |
| mobile | string | Celular |
| assistantName | string | Nome do assistente |
| assistantEmail | string | E-mail do assistente |
| assistantPhone | string | Telefone do assistente |
| observations | string | Observações livres do cadastro |
Respostas de erro
| Mensagem | Causa |
|---|---|
| 会计师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 |