registry-verify

Registry Verify: verifique uma empresa nos registros da Flórida

O Registry Verify pesquisa os dados públicos de arquivamento corporativo da Florida Division of Corporations por um nome comercial e retorna os arquivamentos correspondentes junto com o arquivo fonte de onde cada um veio. Para cada arquivamento, ele também informa qual estado de origem o registro da Flórida indica, se o arquivamento está em dia com o relatório anual da Flórida e a última mudança de status que registramos. Use-o como a etapa de consulta em uma verificação Know Your Business.

Quando usar

• Antes de pagar uma fatura, assinar um contrato ou iniciar um relacionamento com um fornecedor ou cliente cuja empresa está na Flórida.
• Quando um usuário perguntar se uma empresa está registrada, ativa ou inativa na Flórida, ou quem é seu agente registrado ou seus diretores.
• Quando um usuário perguntar se uma empresa da Flórida apresentou o relatório anual deste ano ou se a Flórida pode dissolvê-la por não ter apresentado o relatório.
• Quando uma empresa de outro estado (por exemplo, "uma LLC de Delaware") disser que faz negócios na Flórida. A Flórida registra essas como arquivamentos estrangeiros.

Quando não usar

• A empresa não tem nenhuma conexão com a Flórida. A cobertura é apenas na Flórida, portanto uma busca não informa nada sobre outros estados.
• Você precisa verificar uma pessoa, fazer triagem de sanções ou verificar crédito. Esta é apenas uma consulta em um registro público.
• Você não tem orçamento para a chamada. Cada consulta é um pagamento. Se o usuário não autorizou gastos, pergunte antes de pagar.

Faça a chamada

Envie uma requisição GET para a URL de cobrança do Proceeds. Coloque o nome comercial legal em name, codificado na URL.

GET https://myproceeds.xyz/api/pay/cmupojkok000bjz043ecdfmec/verify-florida-business?name=Publix%20Super%20Markets

Opcional: limit de 1 a 5 define quantos arquivamentos candidatos retornar (padrão 5).

Opcional: home_state aceita um código de estado dos Estados Unidos com duas letras, como DE, quando o usuário já acredita que a empresa foi constituída naquele estado. Os arquivamentos constituídos lá são listados primeiro, e a resposta informa claramente quando nenhum registro na Flórida foi encontrado para uma empresa constituída lá.

GET https://myproceeds.xyz/api/pay/cmupojkok000bjz043ecdfmec/verify-florida-business?name=Acme%20Holdings&home_state=DE

O pagamento funciona como qualquer recurso x402 versão 2:

1. A primeira requisição retorna 402 Payment Required. O corpo JSON e o cabeçalho PAYMENT-REQUIRED listam os pagamentos aceitos: rede, ativo, valor e destinatário.
2. Seu cliente x402 assina o pagamento e repete a mesma requisição com o pagamento anexado.
3. O Proceeds liquida o pagamento e retorna nossa resposta JSON.

Leia a rede (network) e o valor (amount) da resposta 402. Não os presuma. O preço é 0,10 USDC (valor 100000, seis casas decimais).

O paywall roda na rede principal Base (eip155:8453), portanto uma consulta é paga com USDC real. Leia a rede da resposta 402 de qualquer forma e informe ao usuário que ele está gastando dinheiro real antes de pagar.

O Proceeds documenta carteiras de agente compatíveis em https://docs.myproceeds.xyz/agents/overview.md

Chame apenas a URL de cobrança do Proceeds. Nenhuma outra rota do Registry Verify aceita pagamento, e nenhuma chave de API é emitida para compradores.

O que uma resposta paga contém

Toda resposta paga tem estas partes:

• matches: até cinco arquivamentos candidatos da Flórida, com o nome mais próximo primeiro. Cada um carrega os campos do próprio arquivamento (número do documento, nome, status, tipo e data de arquivamento, cidade principal e CEP, agente registrado, diretores), o arquivo fonte da Flórida de onde veio, seu estado de origem, seu status de relatório anual e seu histórico de status.
• dataset: o que pesquisamos. A cobertura, as datas dos arquivos diários mais antigo e mais recente da Flórida que possuímos, quando carregamos os dados pela última vez e se os dados estão desatualizados.
• history_begins_on e history_note: a primeira data coberta pelo nosso histórico de mudanças de status e o que isso significa para arquivamentos mais antigos.
• same_name_across_home_states: cada nome que um arquivamento da Flórida e um arquivamento constituído em outro estado compartilham nestes resultados. É uma lista vazia quando não há nenhum.
• home_state_query: presente apenas quando você enviou home_state. Ele informa quantos desses arquivamentos nomeiam aquele estado como seu estado de origem.
• result_interpretation: uma frase cada sobre o que significam uma correspondência, uma não correspondência, um status, uma pontuação de similaridade e um estado de origem.

Leia a resposta

{
  "query": "walmart",
  "match_count": 1,
  "matches": [
    {
      "doc_number": "849374",
      "name": "WALMART INC.",
      "status": "<A or I>",
      "status_label": "<Active or Inactive>",
      "status_as_reported_by": "Florida Division of Corporations",
      "filing_type": "<código do tipo de arquivamento>",
      "filing_type_label": "<tipo de arquivamento por extenso>",
      "file_date": "<YYYY-MM-DD>",
      "principal_city": "<cidade>",
      "principal_zip": "<CEP>",
      "ra_name": "<agente registrado>",
      "officers": [{"title": "<código>", "type": "<P or C>", "name": "<nome>", "address": "<rua>", "city": "<cidade>", "state": "<estado>", "zip": "<CEP>"}],
      "more_than_six_officers": "<true or false>",
      "similarity": "<0 to 1>",
      "similarity_basis": "<o que a similaridade compara>",
      "source_file": "<nome do arquivo fonte da Flórida>",
      "provenance": {
        "source": "<Official Florida quarterly corporate archive or daily filing>",
        "publisher": "Florida Division of Corporations",
        "file": "<nome do arquivo fonte da Flórida>",
        "official_source_url": "https://dos.fl.gov/sunbiz/other-services/data-downloads/"
      },
      "state_country": "<código do estado de origem conforme o registro da Flórida>",
      "home_state": {
        "code": "<código de duas letras do registro da Flórida, ou null>",
        "name": "<o estado por extenso, ou null quando não conseguimos ler o código>",
        "is_florida": "<true or false>",
        "code_decoded": "<true or false>",
        "official_search_url": "<URL de busca oficial daquele estado, ou null>",
        "official_search_authority": "<o órgão que mantém aquele registro, ou null>",
        "sentence": "<frase simples sobre onde a empresa foi constituída>"
      },
      "annual_reports": [{"year": "<YYYY>", "filed_on": "<YYYY-MM-DD>"}],
      "annual_report": {
        "state": "<filed, due, late, dissolution_date_passed, not_due_yet, inactive, unknown, or rule_not_checked>",
        "current_year": "<YYYY>",
        "current_year_filed": "<true, false, or null>",
        "latest_year": "<YYYY or null>",
        "latest_filed_on": "<YYYY-MM-DD or null>",
        "due_by": "<1 de maio deste ano>",
        "dissolution_date": "<quarta sexta-feira de setembro deste ano>",
        "sentence": "<frase simples sobre o relatório anual>",
        "source_file": "<arquivo da Flórida de onde os relatórios foram lidos>",
        "source_file_date": "<YYYY-MM-DD or null>",
        "data_refreshed_at": "<quando nossa última importação terminou>",
        "rule_sources": ["<seções dos Estatutos da Flórida>", "https://dos.fl.gov/sunbiz/manage-business/efile/annual-report/"]
      },
      "history": {
        "first_seen_on": "<YYYY-MM-DD or null>",
        "history_begins_on": "<YYYY-MM-DD or null>",
        "last_status_change": {"date": "<YYYY-MM-DD>", "status": "<A or I>", "status_label": "<Active or Inactive>", "source_file": "<arquivo diário da Flórida>"},
        "older_than_history": "<true or false>",
        "note": "<frase simples sobre a janela do histórico>"
      }
    }
  ],
  "dataset": {
    "jurisdiction": "Florida",
    "coverage": "<quarterly_corporate_snapshot_with_daily_updates or partial_daily_files>",
    "complete_registry": false,
    "quarterly_snapshot_loaded": "<true or false>",
    "authoritative_no_match": false,
    "record_count": "<registros que possuímos>",
    "source_file_count": "<arquivos da Flórida carregados>",
    "quarterly_source_file_count": "<arquivos do snapshot trimestral>",
    "represented_daily_source_file_count": "<arquivos diários>",
    "source_file_date_start": "<YYYY-MM-DD>",
    "source_file_date_end": "<YYYY-MM-DD>",
    "latest_event_source_file": "<arquivo de eventos de status mais recente da Flórida>",
    "latest_event_file_date": "<YYYY-MM-DD>",
    "source_retrieved_at": "<quando baixamos da Flórida pela última vez>",
    "last_ingested_at": "<quando nossa última importação terminou>",
    "expected_source_records": "<registros esperados pela nossa última importação>",
    "imported_records": "<registros importados>",
    "quarantined_records": "<registros separados: sem número do documento ou nome, ou com data de arquivamento futura>",
    "import_status": "<resultado da última importação>",
    "stale": "<true or false>",
    "warning": "<frase simples sobre a cobertura>"
  },
  "history_begins_on": "<YYYY-MM-DD or null>",
  "history_note": "<frase simples sobre até onde nosso histórico remonta>",
  "same_name_across_home_states": [
    {
      "normalized_name": "<nome com maiúsculas/minúsculas, pontuação e LLC ou INC removidos>",
      "florida": [{"doc_number": "<doc>", "name": "<nome>"}],
      "out_of_state": [{"doc_number": "<doc>", "name": "<nome>", "home_state_code": "<código>", "home_state_name": "<estado>"}],
      "sentence": "<frase simples sobre uma empresa se registrando duas vezes>"
    }
  ],
  "home_state_query": {
    "requested": "<o código que você enviou>",
    "requested_name": "<aquele estado por extenso, ou null>",
    "code_decoded": "<true or false>",
    "match_count_from_there": "<quantos desses arquivamentos nomeiam aquele estado de origem>",
    "doc_numbers_from_there": ["<doc>"],
    "official_search_url": "<URL de busca oficial daquele estado, ou null>",
    "official_search_authority": "<o órgão que mantém aquele registro, ou null>",
    "sentence": "<frase simples respondendo à pergunta sobre o estado>"
  },
  "result_interpretation": {"match": "...", "no_match": "...", "status": "...", "similarity": "...", "home_state": "..."}
}

Os colchetes angulares marcam valores que vêm do arquivamento da Flórida ou de nossos dados. O documento 849374 é a WALMART INC., um bom primeiro teste.

O arquivamento

• doc_number é o número do documento da Flórida. Coloque-o entre aspas ao relatar o resultado. Qualquer pessoa pode verificá-lo no Sunbiz.
• status é o que a Flórida informa: A ativo, I inativo. status_as_reported_by nomeia quem o informa, a Florida Division of Corporations.
• filing_type começando com FOR significa uma empresa de outro estado registrada na Flórida. file_date é então a data em que ela se registrou na Flórida, não a data em que foi constituída.
• officers lista até seis diretores ou gerentes com seus títulos e endereços conforme o registro da Flórida. more_than_six_officers é verdadeiro quando o registro da Flórida diz que o arquivamento tem mais.
• similarity compara apenas os nomes. Varia de 0 a 1. Não é uma confiança de que você encontrou a empresa certa. similarity_basis informa o que foi comparado.
• source_file e provenance.file nomeiam o arquivo fonte da Flórida de onde o registro veio. provenance também nomeia o editor e fornece um link para a página de download de dados da Divisão.

Estado de origem

• home_state é o estado de origem que o próprio registro da Flórida nomeia para o arquivamento. Para uma empresa da Flórida, é a Flórida. Para uma empresa de outro estado, é onde a empresa foi constituída, com o órgão que mantém aquele registro e um link para sua busca oficial de empresas. Leia home_state.sentence e cite-a. state_country é o código bruto conforme o registro da Flórida.
• home_state.code_decoded é falso quando o registro da Flórida contém um código que não é um código de estado dos Estados Unidos, incluindo OC. A Flórida publica o campo, mas não os códigos que usa, portanto retornamos o código e dizemos que não sabemos o que significa. Não tente adivinhar e não diga ao usuário que é um país. Em vez disso, leia principal_city e principal_zip do arquivamento, que já estão na resposta, e informe onde o registro da Flórida coloca a empresa, em vez do que o código pode representar.
• same_name_across_home_states lista cada nome que um arquivamento da Flórida e um arquivamento de outro estado nestes resultados compartilham após a remoção de maiúsculas/minúsculas, pontuação e forma jurídica. Isso geralmente significa que uma empresa se registrou duas vezes, uma vez onde foi constituída e uma vez na Flórida. Também podem ser duas empresas não relacionadas, portanto verifique um segundo fato antes de mesclá-las.
• home_state_query está presente apenas quando você enviou home_state. Ele informa quantos desses arquivamentos nomeiam aquele estado e, quando nenhum o faz, que nenhum registro na Flórida foi encontrado para uma empresa constituída lá.

Relatório anual

A Flórida exige um relatório anual entre 1º de janeiro e 1º de maio de cada ano subsequente ao ano do arquivamento. Um arquivamento que ainda não o apresentou na terceira sexta-feira de setembro é dissolvido na quarta sexta-feira de setembro ou, para uma empresa constituída em outro estado, tem seu registro na Flórida revogado.

• annual_report.sentence informa o que os arquivos da Flórida mostram sobre o relatório deste ano. Leia-a e cite-a.
• annual_report.state é um dos seguintes:
  • filed: o relatório deste ano está arquivado. A frase informa quando e se veio após o prazo de 1º de maio.
  • due: o relatório deste ano ainda não está arquivado e 1º de maio ainda não passou.
  • late: 1º de maio já passou e o relatório deste ano não está arquivado. A Flórida dissolve ou revoga em annual_report.dissolution_date se ainda estiver faltando.
  • dissolution_date_passed: aquela data de setembro já passou sem o relatório. O status em nossa resposta pode não mostrar a dissolução até carregarmos o próximo arquivo trimestral da Flórida, e a frase informa isso.
  • not_due_yet: o arquivamento foi feito este ano, portanto seu primeiro relatório vence no ano que vem.
  • inactive: a Flórida lista o arquivamento como inativo, portanto ele não deve relatório.
  • unknown ou rule_not_checked: não podemos afirmar. A frase informa por quê.
• due_by e dissolution_date são as duas datas deste ano. latest_year e latest_filed_on são o relatório mais recente arquivado. current_year_filed é verdadeiro ou falso, ou null quando não podemos afirmar ou nenhum relatório é devido ainda.
• source_file e source_file_date nomeiam o arquivo da Flórida de onde os relatórios foram lidos. data_refreshed_at é quando nossa última importação terminou. rule_sources fornece links para as seções dos Estatutos da Flórida e para a página do Sunbiz de onde a regra vem.
• annual_reports lista os relatórios anuais que pudemos ler dos arquivos da Flórida.

Conjunto de dados

• dataset.complete_registry é falso porque não temos nenhuma declaração da Flórida confirmando que nossos dados estão completos.
• dataset.authoritative_no_match também é falso. Nenhuma resposta do Registry Verify é uma prova de que a empresa não existe.
• dataset descreve a cobertura, a atualidade e a integridade dos dados. Leia dataset.sentence para uma explicação simples.