Tabela

O que contém

suppliers

Fornecedores cadastrados

documents

Documentos dos fornecedores (formulários, bases públicas e consultas)

form_fields

Respostas de perguntas de formulários

buyer_documents

Campos personalizados preenchidos internamente associados ao fornecedor ou homologação

setting_risks

Configurações de risco dos documentos por categoria

qualifications

Homologações do fornecedor por categoria

approval_steps

Níveis de aprovadores das etapas de aprovação

performances

Respostas de avaliações de performance por ciclo

cnpj_records

Dados cadastrais do CNPJ do fornecedor (base pública da Receita)

tags

Marcadores aplicados ao fornecedor pelo comprador

supplier_users

Usuários com conta na Linkana vinculados ao fornecedor

supplier_related_parties

Partes vinculadas ao fornecedor: sócios do quadro societário da Receita e partes adicionadas pelo comprador

Campo

Tipo

Descrição

id

uuid

ID único do fornecedor

name

string

Razão Social

identifier

string

CNPJ, CPF ou TIN

legal_entity

string

Tipo de pessoa. Valores: pj (Pessoa Jurídica / CNPJ), pf (Pessoa Física / CPF), international (pessoa ou empresa internacional)

country

string

País do fornecedor

state

string

Estado do fornecedor no fluxo. Valores: pending_docs (Aguardando fornecedor), on_review (Aguardando revisão), no_pending_issues (Sem pendências), no_qualification (Sem homologação — fornecedor sem nenhuma categoria)

monitored

boolean

Se o fornecedor está sendo monitorado (conectado à base ativa do comprador)

regularization

boolean

Se o fornecedor está em processo de regularização interna pelo comprador

blocked_at

datetime

Data em que o fornecedor foi bloqueado (vazio se não bloqueado)

blocked_by

string

Nome do usuário que realizou o bloqueio

blocked_reason

string

Motivo do bloqueio

created_at

datetime

Data de criação do registro

updated_at

datetime

Data da última atualização do registro

Campo

Tipo

Descrição

id

uuid

ID único do documento

documentable_id

uuid

ID do objeto associado (ver documentable_type para o tipo)

documentable_type

string

Tipo do objeto associado. Valores: FormGroup (formulário), Certificate (consulta), Check (base pública), BankInformation (dados bancários)

expires_on

date

Data de validade do documento

renew_at

datetime

Data da próxima renovação

reviewed_at

datetime

Data de revisão

reviewed_by

string

E-mail do revisor

reviewer_comment

string

Comentário do revisor

reviewer_refusal_reason

string

Motivo da reprovação

sender_email

string

E-mail de quem enviou o documento

sent_at

datetime

Data de envio/geração

setting_document_id

uuid

Referência às configurações do documento

state

string

Situação do documento. Valores: processing (Pendente), clear (Aprovado), not_clear (Reprovado), ready_to_review (Aguardando revisão), informative (Informativo)

supplier_id

uuid

ID do fornecedor

display_name

string

Nome de exibição do documento

grouper_display_name

string

Grupo de revisão

current

boolean

Indica se é a versão vigente do documento. Filtre por current = true para o mais atual e current = false para versões anteriores

created_at

datetime

Data de criação

updated_at

datetime

Data de atualização

Campo

Tipo

Descrição

id

uuid

ID único

answer

string

Resposta da pergunta. Quando field_type é currency, o valor vem em centavos (dividir por 100 para reais)

form_group_id

uuid

Referência ao grupo de formulário. Para cruzar com documents, usar form_group_id = documentable_id

setting_form_field_id

uuid

Referência à configuração da pergunta — chave estável para identificar a mesma pergunta entre exportações e fornecedores

display_name

string

Nome da pergunta

field_type

string

Tipo de resposta (ex.: currency para valores monetários, entregues em centavos)

hint

string

Dica para a resposta

optional

boolean

Se a resposta é opcional

created_at

datetime

Data de criação

updated_at

datetime

Data de atualização

Campo

Tipo

Descrição

id

uuid

ID único do campo preenchido

supplier_id

uuid

ID do fornecedor

setting_buyer_document_id

uuid

Referência à configuração do campo personalizado

display_name

string

Nome do campo

value

string

Valor preenchido

qualification_id

uuid

Homologação associada ao campo (vazio = campo associado diretamente ao fornecedor)

active

boolean

Se o campo está ativo

disabled

boolean

Se o campo foi arquivado

created_at

datetime

Data de criação

updated_at

datetime

Data de atualização

Campo

Tipo

Descrição

id

uuid

ID único

risk

integer

Pontuação de risco do documento

category_id

uuid

Referência à categoria

setting_document_id

uuid

Referência às configurações do documento

created_at

datetime

Data de criação

updated_at

datetime

Data de atualização

Campo

Tipo

Descrição

id

uuid

ID único da homologação

decision_at

datetime

Data da decisão

decision_score

integer

Score de risco no momento da decisão

initiated_by_email

string

E-mail do usuário que iniciou a homologação

renew_at

datetime

Data da próxima renovação da homologação

state

string

Situação da homologação. Valores: approved (Aprovada), in_progress (Em andamento), refused (Reprovada)

category_id

uuid

Referência à categoria

category_display_name

string

Categoria

category_score

integer

Score de risco da categoria da homologação, do último cálculo consolidado (não é em tempo real). Sem risco configurado vem 100. NULL só quando a categoria ainda não entrou no cálculo mais recente (situação transitória)

supplier_id

uuid

ID do fornecedor

created_at

datetime

Data de criação

updated_at

datetime

Data de atualização

Campo

Tipo

Descrição

id

uuid

ID único

approver_user_email

string

E-mail do usuário aprovador

decision_at

datetime

Data da decisão

decision_reason

string

Motivo padronizado (opcional para aprovação, obrigatório para reprovação)

display_name

string

Nome do nível de aprovação

state

string

Situação do nível. Valores: waiting (Aguardando o nível anterior da etapa), pending (Pendente), approved (Aprovado), refused (Reprovado)

approval_step_last_decision_at

datetime

Data da última decisão tomada na etapa

qualification_id

uuid

Referência à homologação

approval_step_requester_user_email

string

E-mail do usuário que acionou a etapa, se condição de aprovação por exceção

approval_step_skipped

boolean

Se a etapa foi substituída por uma de aprovação por exceção

approval_step_state

string

Situação da etapa. Valores: pending (Pendente), approved (Aprovado), refused (Reprovado)

approval_step_display_name

string

Nome da etapa

created_at

datetime

Data de criação

updated_at

datetime

Data de atualização

decision_comment

string

Comentário livre que o aprovador escreve junto com a decisão, na aprovação ou na reprovação. Fica vazio quando ele não escreve nada

approval_step_id

uuid

ID da etapa a que o nível pertence. Use para agrupar os níveis da mesma etapa: uma etapa pulada e a etapa que a substituiu têm IDs diferentes, mesmo com o mesmo nome

Campo

Tipo

Descrição

id

uuid

ID único

answer

string

Resposta da pergunta

comment

string

Comentário textual do respondente junto com a resposta. Vem vazio (não NULL) quando não há comentário

criterion

string

Critério. Valores: scale_1_to_5 (Escala de 1 a 5), yes_or_no (Sim ou Não)

display_name

string

Nome da pergunta

score

integer

Score calculado

skipped

boolean

Se a pergunta foi ignorada

weight

integer

Peso da pergunta

pillar_display_name

string

Nome do pilar

pillar_score

integer

Score do pilar

pillar_weight

integer

Peso do pilar

evaluation_display_name

string

Nome da avaliação

evaluation_finished_at

datetime

Data em que a avaliação foi finalizada (vazio se ainda não finalizada)

evaluation_identifier

string

Identificador único interno do cliente

evaluation_score

integer

Score da avaliação

evaluation_state

string

Situação da avaliação. Valores: pending (Pendente), answering (Parcialmente respondida), answered (Respondida)

supplier_id

uuid

ID do fornecedor

evaluation_user_email

string

E-mail do usuário que iniciou a avaliação

cycle_active

boolean

Se é o ciclo atual do cliente

cycle_display_name

string

Nome do ciclo

created_at

datetime

Data de criação

updated_at

datetime

Data de atualização

Campo

Tipo

Descrição

id

uuid

ID único do registro

supplier_id

uuid

ID do fornecedor

cnpj

string

CNPJ do fornecedor (texto — preserva zeros à esquerda e acomoda o CNPJ alfanumérico; trate como string em qualquer cruzamento)

razao_social

string

Razão social

nome_fantasia

string

Nome fantasia

mf

string

Indicador matriz/filial (1 = matriz)

cod_situacao_cadastral

string

Código da situação cadastral

data_situacao_cadastral

date

Data da situação cadastral

cod_porte_empresa

integer

Código do porte da empresa

cod_natureza_juridica

integer

Código da natureza jurídica

cnae_fiscal

string

CNAE fiscal principal

cnaes_secundarios

string

CNAEs secundários, separados por vírgula

data_inicio_atividade

date

Data de início de atividade

capital_social

integer

Capital social em centavos (dividir por 100 para reais)

forma_tributacao

string

Regime tributário da empresa. Valores: simples_nacional (Simples Nacional), simei (Simples Nacional / MEI), lucro_presumido (Lucro Presumido), lucro_real (Lucro Real), lucro_arbitrado (Lucro Arbitrado), imune (Imune), isento (Isento), null (Não identificado)

desc_tipo_logradouro

string

Tipo de logradouro (Rua, Avenida, etc.)

logradouro

string

Logradouro

numero

string

Número do endereço

complemento

string

Complemento do endereço

bairro

string

Bairro

descricao_municipio

string

Município

uf

string

Unidade federativa

cep

string

CEP

correio_eletronico

string

E-mail de contato

ddd1

string

DDD do telefone principal

telefone1

string

Telefone principal

created_at

datetime

Data de criação

updated_at

datetime

Data de atualização

Campo

Tipo

Descrição

id

uuid

ID único do marcador

supplier_id

uuid

ID do fornecedor

display_name

string

Nome do marcador

created_at

datetime

Data de criação

updated_at

datetime

Data de atualização

Campo

Tipo

Descrição

id

uuid

ID único do vínculo entre o usuário e o fornecedor

supplier_id

uuid

ID do fornecedor

email

string

E-mail do usuário vinculado ao fornecedor

created_at

datetime

Data em que o vínculo foi criado (não é a data de criação da conta do usuário)

updated_at

datetime

Data da última atualização do vínculo (não da conta)

Campo

Tipo

Descrição

id

uuid

ID único da parte vinculada

supplier_id

uuid

ID do fornecedor

name

string

Nome (PF) ou razão social (PJ) da parte vinculada

legal_entity

string

Tipo de pessoa. Valores: PF (Pessoa Física), PJ (Pessoa Jurídica)

cnpj

string

CNPJ da parte vinculada PJ (texto, que preserva os zeros à esquerda). Fica vazio para PF

cpf_anonymized

string

CPF mascarado como a Receita divulga, só com os 6 dígitos do meio visíveis (ex.: ***.456.789-**). Fica vazio para PJ e para partes adicionadas manualmente

cod_qualificacao_socio

integer

Código da qualificação do sócio na Receita Federal (ex.: 22 Sócio, 49 Sócio-Administrador). Fica vazio para partes manuais

cod_pais

string

Código do país do sócio estrangeiro, conforme a Receita. Fica vazio para sócio brasileiro e para partes manuais

data_entrada_sociedade

date

Data de entrada no quadro societário. Fica vazio para partes manuais

origin

string

Origem do registro. Valores: receita (quadro societário da Receita), manual (adicionada pelo comprador)

active

boolean

Se a parte vinculada está ativa. Um sócio que sai do quadro societário passa a false, e o comprador também pode desativar

created_at

datetime

Data de criação

updated_at

datetime

Data de atualização

Objeto

URL

Campo utilizado

Fornecedor

https://app.linkana.com/srm/suppliers/{supplier_id}/panel

supplier_id (ou id de suppliers)

Documento

https://app.linkana.com/srm/documents/{document_id}

id de documents

Campo personalizado

https://app.linkana.com/srm/buyer_documents/{id}

id de buyer_documents