TF Fiscal

Plataforma e integraciones

Contador

1 endpoints

API para consulta de los datos de registro de contadores vinculados a una empresa. Útil para sistemas contables externos que necesitan obtener los datos completos del contador responsable de una empresa determinada.

POST/api/accountant/get_info

Obtener datos del contador

Devuelve los datos completos de registro del contador vinculado a la empresa informada. El contador debe estar previamente vinculado a la empresa (mismo CNPJ) y el correo informado debe coincidir con el registro.

Headers obligatorios

HeaderTipoDescripción
tokenstringToken de la empresa o token B2B del integrador
signstringFirma MD5: MD5(token + path + body + timestamp)
timestampstringUnix timestamp en segundos (ventana de 5 minutos)

Body

CampoTipoDescripción
companyId *intID de la empresa vinculada al token
accountantId *stringObjectId del contador (24 hex)
email *stringCorreo del contador (debe coincidir con el registro)

* Campo obligatorio.

Campos de la respuesta

CampoTipoDescripción
emailstringCorreo principal del contador
officeDocumentTypestringTipo de documento de la oficina: "CNPJ" o "CPF"
officeDocumentstringDocumento de la oficina (solo dígitos)
officeNamestringRazón social / nombre de la oficina
responsibleNamestringNombre del contador responsable
crcstringNúmero del CRC (Consejo Regional de Contabilidad)
accountantCpfstringCPF del contador (solo dígitos)
workAddressstringDirección comercial
sitestringSitio web de la oficina
landlinestringTeléfono fijo
mobilestringMóvil
assistantNamestringNombre del asistente
assistantEmailstringCorreo del asistente
assistantPhonestringTeléfono del asistente
observationsstringObservaciones libres del registro

Respuestas de error

MensajeCausa
会计师ID参数异常或不存在accountantId ausente o no es un ObjectId válido
该会计师邮箱异常或不存在email inválido o no registrado
发票账号{companyId}异常或不存在companyId no pertenece al usuario del token
该会计师未绑定该发票账号El contador no está vinculado a la empresa informada