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_infoObtener 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
| Header | Tipo | Descripción |
|---|---|---|
| token | string | Token de la empresa o token B2B del integrador |
| sign | string | Firma MD5: MD5(token + path + body + timestamp) |
| timestamp | string | Unix timestamp en segundos (ventana de 5 minutos) |
Body
| Campo | Tipo | Descripción |
|---|---|---|
| companyId * | int | ID de la empresa vinculada al token |
| accountantId * | string | ObjectId del contador (24 hex) |
| email * | string | Correo del contador (debe coincidir con el registro) |
* Campo obligatorio.
Campos de la respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| string | Correo principal del contador | |
| officeDocumentType | string | Tipo de documento de la oficina: "CNPJ" o "CPF" |
| officeDocument | string | Documento de la oficina (solo dígitos) |
| officeName | string | Razón social / nombre de la oficina |
| responsibleName | string | Nombre del contador responsable |
| crc | string | Número del CRC (Consejo Regional de Contabilidad) |
| accountantCpf | string | CPF del contador (solo dígitos) |
| workAddress | string | Dirección comercial |
| site | string | Sitio web de la oficina |
| landline | string | Teléfono fijo |
| mobile | string | Móvil |
| assistantName | string | Nombre del asistente |
| assistantEmail | string | Correo del asistente |
| assistantPhone | string | Teléfono del asistente |
| observations | string | Observaciones libres del registro |
Respuestas de error
| Mensaje | Causa |
|---|---|
| 会计师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 |