Registry Verify: Florida-Unternehmensprüfung

Registry Verify: Überprüfung eines Unternehmens anhand der Florida-Register

Registry Verify durchsucht die öffentlichen Handelsregisterdaten (public filing data) des Florida Division of Corporations nach einem Firmennamen und gibt die passenden Einträge (Filings) zusammen mit der Quelldatei, aus der sie stammen, zurück. Für jeden Eintrag wird außerdem angegeben, welchen Heimatstaat (home state) das Register von Florida führt, ob der Eintrag seinen Jahresbericht (annual report) für Florida eingereicht hat, und die letzte von uns erfasste Statusänderung. Nutzen Sie es als Registerabfrage-Schritt einer Know Your Business-Prüfung.

Wann es verwendet werden sollte

• Vor der Bezahlung einer Rechnung, der Unterzeichnung eines Vertrags oder der Aufnahme eines Lieferanten oder Kunden, dessen Unternehmen in Florida ansässig ist.
• Wenn ein Benutzer fragt, ob ein Unternehmen in Florida registriert, aktiv oder inaktiv ist, oder wer sein eingetragener Vertreter (registered agent) oder seine Führungskräfte (officers) sind.
• Wenn ein Benutzer fragt, ob ein Florida-Unternehmen den Jahresbericht für dieses Jahr eingereicht hat, oder ob Florida es wegen eines fehlenden Berichts auflösen könnte.
• Wenn ein Unternehmen aus einem anderen Bundesstaat (z.B. „eine Delaware LLC“) angibt, in Florida tätig zu sein. Florida registriert diese als ausländische Einträge (foreign filings).

Wann es nicht verwendet werden sollte

• Das Unternehmen hat keine Verbindung zu Florida. Die Abdeckung beschränkt sich auf Florida, daher gibt eine Suche keine Auskunft über andere Bundesstaaten.
• Sie müssen eine Person überprüfen, Sanktionslisten screenen oder die Bonität prüfen. Dies ist ausschließlich eine Registerabfrage.
• Sie haben kein Budget für den Aufruf. Jede Abfrage kostet Geld. Wenn der Benutzer keine Ausgaben autorisiert hat, fragen Sie vor der Zahlung.

Den Aufruf durchführen

Senden Sie eine GET-Anfrage an die Proceeds-Charge-URL. Setzen Sie den rechtlichen Firmennamen in den Parameter name, URL-kodiert.

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

Optional: limit von 1 bis 5 legt fest, wie viele Kandidaten-Einträge zurückkommen (Standard 5).

Optional: home_state akzeptiert einen zweistelligen US-Bundesstaatscode, z.B. DE, wenn der Benutzer bereits glaubt, dass das Unternehmen in diesem Staat gegründet wurde. Einträge, die dort gegründet wurden, werden zuerst aufgelistet, und die Antwort gibt klar an, wenn keine Florida-Registrierung für ein dort gegründetes Unternehmen gefunden wurde.

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

Die Bezahlung funktioniert wie bei jeder x402 Version 2 Ressource:

1. Die erste Anfrage gibt 402 Payment Required zurück. Der JSON-Textkörper und der PAYMENT-REQUIRED-Header listen die akzeptierten Zahlungen auf: Netzwerk, Asset, Betrag und Empfänger.
2. Ihr x402-Client signiert die Zahlung und wiederholt dieselbe Anfrage mit der angehängten Zahlung.
3. Proceeds wickelt die Zahlung ab und gibt unsere JSON-Antwort zurück.

Lesen Sie das Netzwerk und den Betrag aus der 402-Antwort. Gehen Sie nicht von ihnen aus. Der Preis beträgt 0,10 USDC (Betrag 100000, sechs Dezimalstellen).

Die Paywall läuft auf Base Mainnet (eip155:8453), daher wird eine Abfrage mit echten USDC bezahlt. Lesen Sie das Netzwerk trotzdem aus der 402-Antwort und teilen Sie dem Benutzer mit, dass er echtes Geld ausgibt, bevor Sie bezahlen.

Proceeds dokumentiert kompatible Agenten-Wallets unter https://docs.myproceeds.xyz/agents/overview.md

Rufen Sie ausschließlich die Proceeds-Charge-URL auf. Keine andere Registry Verify-Route akzeptiert Zahlungen, und es wird kein API-Schlüssel an Käufer ausgegeben.

Was eine bezahlte Antwort enthält

Jede bezahlte Antwort enthält diese Teile:

• matches: bis zu fünf Florida-Kandidaten-Einträge, der ähnlichste Name zuerst. Jeder trägt die eigenen Felder des Eintrags (Dokumentennummer, Name, Status, Gründungsart und -datum, Hauptort und PLZ, eingetragener Vertreter, Führungskräfte), die Florida-Quelldatei, aus der er stammt, seinen Heimatstaat, seinen Jahresberichtstatus und seine Statushistorie.
• dataset: wonach wir gesucht haben. Die Abdeckung, die Daten der ältesten und neuesten Florida-Tagesdateien, die wir besitzen, wann wir zuletzt Daten geladen haben und ob die Daten veraltet sind.
• history_begins_on und history_note: das erste Datum, das unsere Statusänderungshistorie abdeckt, und was das für ältere Einträge bedeutet.
• same_name_across_home_states: jeder Name, den ein Florida-Eintrag und ein in einem anderen Staat gegründeter Eintrag in diesen Ergebnissen gemeinsam haben. Es ist eine leere Liste, wenn es keinen gibt.
• home_state_query: nur vorhanden, wenn Sie home_state gesendet haben. Es gibt an, wie viele dieser Einträge diesen Staat als ihren Heimatstaat nennen.
• result_interpretation: jeweils ein Satz darüber, was ein Treffer, ein Nichttreffer, ein Status, ein Ähnlichkeitswert und ein Heimatstaat bedeuten.

Die Antwort lesen

{
  "query": "walmart",
  "match_count": 1,
  "matches": [
    {
      "doc_number": "849374",
      "name": "WALMART INC.",
      "status": "<A oder I>",
      "status_label": "<Aktiv oder Inaktiv>",
      "status_as_reported_by": "Florida Division of Corporations",
      "filing_type": "<Code der Gründungsart>",
      "filing_type_label": "<Gründungsart in Worten>",
      "file_date": "<YYYY-MM-DD>",
      "principal_city": "<Stadt>",
      "principal_zip": "<PLZ>",
      "ra_name": "<Eingetragener Vertreter>",
      "officers": [{"title": "<Code>", "type": "<P oder C>", "name": "<Name>", "address": "<Straße>", "city": "<Stadt>", "state": "<Staat>", "zip": "<PLZ>"}],
      "more_than_six_officers": "<true oder false>",
      "similarity": "<0 bis 1>",
      "similarity_basis": "<womit die Ähnlichkeit verglichen wird>",
      "source_file": "<Name der Florida-Quelldatei>",
      "provenance": {
        "source": "<Offizielles Florida-Quartalsunternehmensarchiv oder täglicher Eintrag>",
        "publisher": "Florida Division of Corporations",
        "file": "<Name der Florida-Quelldatei>",
        "official_source_url": "https://dos.fl.gov/sunbiz/other-services/data-downloads/"
      },
      "state_country": "<Heimatstaatscode, wie ihn das Register von Florida führt>",
      "home_state": {
        "code": "<Zweistelliger Code aus dem Florida-Register oder null>",
        "name": "<Der Staat in Worten oder null, wenn wir den Code nicht lesen können>",
        "is_florida": "<true oder false>",
        "code_decoded": "<true oder false>",
        "official_search_url": "<Offizielle Unternehmenssuche dieses Staates oder null>",
        "official_search_authority": "<Die Behörde, die dieses Register führt, oder null>",
        "sentence": "<Einfacher Satz darüber, wo das Unternehmen gegründet wurde>"
      },
      "annual_reports": [{"year": "<YYYY>", "filed_on": "<YYYY-MM-DD>"}],
      "annual_report": {
        "state": "<filed, due, late, dissolution_date_passed, not_due_yet, inactive, unknown oder rule_not_checked>",
        "current_year": "<YYYY>",
        "current_year_filed": "<true, false oder null>",
        "latest_year": "<YYYY oder null>",
        "latest_filed_on": "<YYYY-MM-DD oder null>",
        "due_by": "<1. Mai dieses Jahres>",
        "dissolution_date": "<Vierter Freitag im September dieses Jahres>",
        "sentence": "<Einfacher Satz über den Jahresbericht>",
        "source_file": "<Florida-Datei, aus der die Berichte gelesen wurden>",
        "source_file_date": "<YYYY-MM-DD oder null>",
        "data_refreshed_at": "<Wann unser letzter Import endete>",
        "rule_sources": ["<Abschnitte der Florida Statutes>", "https://dos.fl.gov/sunbiz/manage-business/efile/annual-report/"]
      },
      "history": {
        "first_seen_on": "<YYYY-MM-DD oder null>",
        "history_begins_on": "<YYYY-MM-DD oder null>",
        "last_status_change": {"date": "<YYYY-MM-DD>", "status": "<A oder I>", "status_label": "<Aktiv oder Inaktiv>", "source_file": "<Florida-Tagesdatei>"},
        "older_than_history": "<true oder false>",
        "note": "<Einfacher Satz über das Historienfenster>"
      }
    }
  ],
  "dataset": {
    "jurisdiction": "Florida",
    "coverage": "<quarterly_corporate_snapshot_with_daily_updates oder partial_daily_files>",
    "complete_registry": false,
    "quarterly_snapshot_loaded": "<true oder false>",
    "authoritative_no_match": false,
    "record_count": "<von uns gehaltene Datensätze>",
    "source_file_count": "<geladene Florida-Dateien>",
    "quarterly_source_file_count": "<Dateien aus dem Quartalssnapshot>",
    "represented_daily_source_file_count": "<Tagesdateien>",
    "source_file_date_start": "<YYYY-MM-DD>",
    "source_file_date_end": "<YYYY-MM-DD>",
    "latest_event_source_file": "<neueste Florida-Statusereignisdatei>",
    "latest_event_file_date": "<YYYY-MM-DD>",
    "source_retrieved_at": "<Wann wir zuletzt von Florida heruntergeladen haben>",
    "last_ingested_at": "<Wann unser letzter Import endete>",
    "expected_source_records": "<Datensätze, die unser letzter Import erwartet hat>",
    "imported_records": "<von ihm importierte Datensätze>",
    "quarantined_records": "<von ihm zurückgestellte Datensätze: keine Dokumentennummer oder kein Name, oder ein zukünftiges Gründungsdatum>",
    "import_status": "<Ergebnis des letzten Imports>",
    "stale": "<true oder false>",
    "warning": "<Einfacher Satz über die Abdeckung>"
  },
  "history_begins_on": "<YYYY-MM-DD oder null>",
  "history_note": "<Einfacher Satz darüber, wie weit unsere Historie zurückreicht>",
  "same_name_across_home_states": [
    {
      "normalized_name": "<Name ohne Groß-/Kleinschreibung, Zeichensetzung und LLC oder INC>",
      "florida": [{"doc_number": "<Dok>", "name": "<Name>"}],
      "out_of_state": [{"doc_number": "<Dok>", "name": "<Name>", "home_state_code": "<Code>", "home_state_name": "<Staat>"}],
      "sentence": "<Einfacher Satz über ein Unternehmen, das sich zweimal registriert>"
    }
  ],
  "home_state_query": {
    "requested": "<der von Ihnen gesendete Code>",
    "requested_name": "<dieser Staat in Worten oder null>",
    "code_decoded": "<true oder false>",
    "match_count_from_there": "<wie viele dieser Einträge diesen Heimatstaat nennen>",
    "doc_numbers_from_there": ["<Dok>"],
    "official_search_url": "<Offizielle Unternehmenssuche dieses Staates oder null>",
    "official_search_authority": "<Die Behörde, die dieses Register führt, oder null>",
    "sentence": "<Einfacher Satz zur Beantwortung der staatenübergreifenden Frage>"
  },
  "result_interpretation": {"match": "...", "no_match": "...", "status": "...", "similarity": "...", "home_state": "..."}
}

Spitze Klammern kennzeichnen Werte, die aus dem Florida-Eintrag oder aus unseren Daten stammen. Dokument 849374 ist WALMART INC., ein guter erster Test.

Der Eintrag

• doc_number ist die Florida-Dokumentennummer. Zitieren Sie sie, wenn Sie das Ergebnis melden. Jeder kann sie auf Sunbiz überprüfen.
• status gibt an, was Florida meldet: A aktiv, I inaktiv. status_as_reported_by nennt den Melder, das Florida Division of Corporations.
• filing_type, das mit FOR beginnt, bedeutet ein Unternehmen aus einem anderen Staat, das in Florida registriert ist. file_date ist dann das Datum der Registrierung in Florida, nicht das Gründungsdatum.
• officers listet bis zu sechs Führungskräfte oder Manager mit ihren Titeln und Adressen auf, wie sie das Register von Florida führt. more_than_six_officers ist wahr, wenn das Register von Florida angibt, dass der Eintrag mehr hat.
• similarity vergleicht nur Namen. Er reicht von 0 bis 1. Es ist kein Konfidenzwert, dass Sie das richtige Unternehmen gefunden haben. similarity_basis gibt an, was verglichen wurde.
• source_file und provenance.file nennen die Florida-Quelldatei, aus der der Datensatz stammt. provenance nennt auch den Herausgeber und verlinkt die Download-Seite der Behörde.

Heimatstaat

• home_state ist der Heimatstaat, den das eigene Register von Florida für den Eintrag nennt. Für ein Florida-Unternehmen ist es Florida. Für ein Unternehmen aus einem anderen Staat ist es der Staat, in dem das Unternehmen gegründet wurde, mit der Behörde, die dieses Register führt, und einem Link zu dessen offizieller Unternehmenssuche. Lesen Sie home_state.sentence und zitieren Sie ihn. state_country ist der rohe Code, wie ihn das Register von Florida führt.
• home_state.code_decoded ist falsch, wenn das Register von Florida einen Code führt, der kein US-Bundesstaatscode ist, darunter OC. Florida veröffentlicht das Feld, aber nicht die Codes, die es verwendet. Daher geben wir den Code zurück und sagen, dass wir nicht wissen, was er bedeutet. Raten Sie nicht, und teilen Sie dem Benutzer nicht mit, dass es ein Land sei. Lesen Sie stattdessen principal_city und principal_zip des Eintrags, die bereits in der Antwort enthalten sind, und sagen Sie, wo das Register von Florida das Unternehmen verortet, anstatt was der Code bedeuten könnte.
• same_name_across_home_states listet jeden Namen auf, den ein Florida-Eintrag und ein auswärtiger Eintrag in diesen Ergebnissen gemeinsam haben, nachdem Groß-/Kleinschreibung, Zeichensetzung und die Rechtsform entfernt wurden. Das bedeutet oft, dass ein Unternehmen sich zweimal registriert hat, einmal dort, wo es gegründet wurde, und einmal in Florida. Es können auch zwei nicht verwandte Unternehmen sein. Überprüfen Sie daher eine zweite Tatsache, bevor Sie sie zusammenführen.
• home_state_query ist nur vorhanden, wenn Sie home_state gesendet haben. Es gibt an, wie viele dieser Einträge diesen Staat nennen, und wenn keiner dies tut, dass keine Florida-Registrierung für ein dort gegründetes Unternehmen gefunden wurde.

Jahresbericht

Florida verlangt einen Jahresbericht zwischen dem 1. Januar und dem 1. Mai eines jeden Jahres nach dem Jahr, in dem ein Eintrag vorgenommen wurde. Ein Eintrag, der am dritten Freitag im September noch fehlt, wird am vierten Freitag im September aufgelöst, oder, für ein in einem anderen Staat gegründetes Unternehmen, wird seine Florida-Registrierung widerrufen.

• annual_report.sentence gibt an, was die Florida-Dateien über den Bericht dieses Jahres zeigen. Lesen Sie ihn und zitieren Sie ihn.
• annual_report.state ist einer von:
  • filed: Der Bericht dieses Jahres liegt vor. Der Satz gibt an, wann, und ob er nach dem 1. Mai-Frist eingereicht wurde.
  • due: Der Bericht dieses Jahres liegt noch nicht vor und der 1. Mai ist noch nicht vorbei.
  • late: Der 1. Mai ist vorbei und der Bericht dieses Jahres liegt nicht vor. Florida löst auf oder widerruft am annual_report.dissolution_date, falls er immer noch fehlt.
  • dissolution_date_passed: Dieses September-Datum ist vergangen, ohne dass der Bericht vorliegt. Der Status in unserer Antwort zeigt die Auflösung möglicherweise erst an, wenn wir Floridas nächste Quartalsdatei laden, und der Satz sagt dies.
  • not_due_yet: Der Eintrag wurde in diesem Jahr vorgenommen, daher ist sein erster Bericht im nächsten Jahr fällig.
  • inactive: Florida führt den Eintrag als inaktiv, daher schuldet er keinen Bericht.
  • unknown oder rule_not_checked: Wir können es nicht sagen. Der Satz erklärt warum.
• due_by und dissolution_date sind die beiden Daten dieses Jahres. latest_year und latest_filed_on sind der neueste eingereichte Bericht. current_year_filed ist wahr oder falsch, oder null, wenn wir es nicht sagen können oder noch kein Bericht fällig ist.
• source_file und source_file_date nennen die Florida-Datei, aus der die Berichte gelesen wurden. data_refreshed_at ist der Zeitpunkt, an dem unser letzter Import endete. rule_sources verlinkt die Abschnitte der Florida Statutes und die Sunbiz-Seite, von der die Regel stammt.
• annual_reports ist die vollständige Liste der Berichte, die wir in den Florida-Dateien gefunden haben.

Statushistorie

• history.first_seen_on ist das Datum, an dem ein Eintrag zum ersten Mal in unseren Florida-Dateien auftrat. Für alte Einträge könnte es das Datum sein, an dem wir unseren ersten Quartalssnapshot geladen haben.
• history.last_status_change ist das letzte Mal, als Florida den Status auf aktiv oder inaktiv gesetzt hat, und aus welcher Datei diese Änderung stammt.
• history.older_than_history ist wahr, wenn der Eintrag vor Beginn unserer Historie existierte. history.note sagt es in Worten.
• history_begins_on (auf oberster Ebene) ist für alle Einträge in dieser Antwort gleich. history_note sagt, was diese Lücke bedeutet.

Der Datensatz

Das Feld dataset betrifft die gesamte Antwort, nicht einen einzelnen Eintrag.

• jurisdiction ist immer Florida.
• coverage ist quarterly_corporate_snapshot_with_daily_updates, wenn wir den vollständigen Quartalssnapshot des Florida Division of Corporations und die letzten Ergänzungen, Änderungen und Löschungen geladen haben. Es ist partial_daily_files, wenn wir nur Tagesdateien geladen haben.
• complete_registry ist wahr, wenn wir den vollständigen Quartalssnapshot geladen haben. Standardmäßig ist es falsch, und authoritative_no_match ist falsch. Wenn wir die vollständige Datei laden, sind beide wahr.
• record_count ist die Anzahl der Datensätze in unserer Datenbank. expected_source_records ist die Anzahl, die wir erwartet haben. quarantined_records sind Datensätze ohne Dokumentennummer oder Name oder mit einem zukünftigen Gründungsdatum.
• source_file_date_start, source_file_date_end, latest_event_source_file und latest_event_file_date beziehen sich auf die Florida-Dateien, die wir in dieser Instanz unserer Datenbank geladen haben.
• source_retrieved_at ist, wann wir zuletzt von den Servern der Florida Division of Corporations heruntergeladen haben. last_ingested_at ist, wann dieser Import endete.
• stale ist wahr, wenn seit 30 Tagen oder länger kein Import durchgeführt wurde. warning sagt, dass die Ergebnisse älter als einen Monat sein könnten.

skandalöse Fehler

• Wenn wir die Florida-Dateien nicht lesen können, gibt die Antwort keine Einträge zurück. Der Status import_status sagt, dass der Import fehlgeschlagen ist.
• Wenn wir den home_state-Code nicht dekodieren können, sagen wir es. Raten Sie nicht. Lesen Sie stattdessen principal_city und principal_zip.
• Ein Eintrag, von dem Florida sagt, dass er aufgelöst ist, kann immer noch einen status von A und eine status_label von Active haben, bis Florida die nächste Quartalsdatei veröffentlicht, die die Auflösung widerspiegelt. annual_report.state von dissolution_date_passed sagt, dass die Auflösung aussteht. Lesen Sie annual_report.sentence.
• Die Ähnlichkeit ist kein Konfidenzwert. Sie vergleicht nur den Namen. Überprüfen Sie die Adresse, den eingetragenen Vertreter, die Führungskräfte und die Jahresberichtshistorie des Kandidaten gegen das, was Sie über das Unternehmen wissen. Behandeln Sie es als Kandidatenvergleich (candidate name match), nicht als Identitätsnachweis.
• Viele Einträge haben dieselbe oder eine sehr ähnliche Adresse. Das ist in Florida üblich (registrierte Vertreter teilen sich Adressen). Verwenden Sie die Dokumentennummer und das Gründungsdatum, um sie zu unterscheiden.

Siehe auch

• https://www.myproceeds.xyz/ (Proceeds)
• https://docs.myproceeds.xyz/agents/overview.md (Agentendokumentation)
• https://dor.myflorida.com/taxes/taxes-and-fees/business-tax/ (Florida Geschäftssteuerabfrage, getrennt vom Handelsregister)